Geographic Coordinate to IANA Timezone API

Sub-millisecond WGS84 coordinate to IANA timezone resolution with DST transition offsets.

原始信息汇总

数据集概述

API名称: Geographic Coordinate to IANA Timezone API 提供方: magebase 类别: Location 订阅用户数: 1

核心功能

该API实现了从WGS84地理坐标（纬度/经度）到IANA时区标识符的确定性解析，同时提供夏令时（DST）偏移信息。其设计目标是替代高成本的第三方地图时区服务，适用于高吞吐量的物联网、物流和车队遥测场景。

主要特点

• 性能: 在300多个全球边缘节点上执行，延迟低于15毫秒；p99延迟在北美、欧洲和亚太地区低于50毫秒。
• 合规性: 严格遵循IANA TZDB 2024a、ISO 8601及WGS84大地基准标准。
• 成本效益: 无增量可变成本（无LLM推理或第三方付费依赖），定价实惠。
• 可靠性: 全球可用性保证为99.99%，采用无服务器Anycast架构。
• 易集成: 提供干净的JSON REST API（通过HTTPS），支持Python、Node.js和cURL。

端点

• 生产网关: https://rapidfund-marketplace-apis.magebase-dev.workers.dev
• 端点路径: GET /v1/geo/timezone
• 请求参数:
  • lat (必填): WGS84纬度，范围-90.0至90.0。
  • lng (必填): WGS84经度，范围-180.0至180.0。
• 示例请求: GET https://rapidfund-marketplace-apis.magebase-dev.workers.dev/v1/geo/timezone?lat=40.7128&lng=-74.0060
• 认证: 需通过RapidAPI标准请求头（X-RapidAPI-Key、X-RapidAPI-Host）认证。

响应示例

成功响应（200 OK）返回JSON格式数据，包括状态、输入的坐标、解析出的时区ID、标准UTC偏移（秒）、夏令时偏移（秒）以及当前是否处于夏令时。例如，对于纽约坐标(40.7128, -74.0060)，返回timezone_id为America/New_York。

错误处理

API返回标准的HTTP状态码，处理异常情况：

• 400 Bad Request: 参数缺失或格式错误。
• 404 Not Found: 请求的资源或路由不存在。
• 429 Too Many Requests: 超出套餐配额或速率限制。
• 500 Internal Error: 边缘处理故障，建议指数退避重试。

应用场景

• 物联网遥测数据的时间戳规范化。
• 网约车/配送服务调度。
• 日历通知分发。
• 批处理流水线、CI/CD门禁及实时结账流程。

定价与服务等级

套餐	月费	每月请求数	速率限制（请求/秒）
Basic	$0	50	5
Pro	$19	5,000	25
Ultra	$79	25,000	50
Mega	$249	100,000	100

核心卖点

提供亚毫秒级WGS84坐标到IANA时区的解析，并包含夏令时转换偏移，显著降低传统企业级时区服务（如Google Maps）的高额合同成本与集成复杂度。