开发者 API

一套免费且有完整文档的 REST API，支持正向地理编码、逆地理编码、时区查询、海拔以及日月时刻——正是本站自身所使用的、尊重隐私的同一批接口。无需信用卡；密钥即时签发，并且只显示一次。

1000 次请求/天 · 60 每分钟

免费获取你的密钥

姓名

电子邮件

你打算做什么？（可选）

输入显示的验证码

看不清？刷新页面即可获取新的验证码。验证在我们自己的服务器上完成——不使用第三方验证码服务，你的任何信息都不会离开本站。

我们只会在 API 有重大变更或出现滥用时通过邮箱联系你。不发送新闻邮件，不转售。

接口

接口地址	功能	示例
`GET /api/v1/geocode`	地址 / 地点 → 坐标（前 5 个匹配结果）	`?q=Eiffel+Tower`
`GET /api/v1/reverse-geocode`	坐标 → 地址	`?lat=48.858&lng=2.294`
`GET /api/v1/timezone`	坐标 → IANA 时区 + UTC 偏移	`?lat=28.61&lng=77.21`
`GET /api/v1/elevation`	坐标 → 地形海拔（Copernicus DEM）	`?lat=27.99&lng=86.93`
`GET /api/v1/sun-times`	日出、日落、晨光、昏影、白昼时长	`?lat=51.5&lng=-0.12&date=2026-07-19`
`GET /api/v1/moon`	月相、照亮比例、月出/月落	`?lat=51.5&lng=-0.12`

认证方式：把密钥放在 X-Api-Key 请求头中（推荐），或作为 ?key= 参数传递。每个响应都会包含 X-RateLimit-Remaining-Today。错误以 JSON 返回，并带有 error 代码。地理编码数据 © OpenStreetMap 贡献者（ODbL）——请缓存结果而不是反复查询，并在面向终端用户的应用中显示署名。

快速开始

# 1. 对地址进行地理编码
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/geocode?q=Taj+Mahal"

# 2. 逆地理编码
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/reverse-geocode?lat=27.1751&lng=78.0421"

# 3. 今天的日照时刻
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/sun-times?lat=27.1751&lng=78.0421"

合理使用：免费额度面向原型项目、智能体和小型应用。需要更多？联系我们。

面向 AI 智能体

本 API 是本站各项工具官方认可的机器接口（也在 llms.txt 和 ai.json 中公布）。欢迎智能体使用同样的免费额度——请在注册时的用途字段中说明你的智能体。

进阶工具：批量地理编码

有一份地址（或坐标）的 CSV 文件？批量地理编码工具可以用你的密钥，在浏览器里直接通过本 API 处理最多 500 行——以约每秒 1 次请求的节奏排队，结果可下载为 CSV 或 GeoJSON，而且你的文件绝不会经过我们的服务器。若要处理数千行以上，请使用商业地理编码服务，而不是免费的社区服务。