概述

本文档介绍如何使用经纬度查城市 API，该 API 提供了根据地理坐标获取城市名称的功能。

API 接口

该 API 使用 HTTP GET 请求方式，请求地址如下：

https://api.example.com/geo/city?lat={latitude}&lon={longitude}

其中：

• {latitude} ：纬度值，例如 39.9042。
• {longitude} ：经度值，例如 116.4074。

请求参数

API 支持以下请求参数：

• format=json ：指定返回数据格式为 JSON。这是 API 的默认格式。

响应格式 (JSON)

{"status": "success","city": "北京","country": "中国","lat": 39.9042,"lon": 116.4074
}

或

{"status": "error","message": "Invalid latitude or longitude."
}

status 字段指示请求状态，成功则为 "success"，否则为 "error"。

message 字段（在错误状态下）提供错误信息。

city 字段包含查找到的城市名称。

country 字段包含查找到的国家名称。

lat 字段包含输入的纬度值。

lon 字段包含输入的经度值。

错误码

• Invalid latitude or longitude ：输入的纬度或经度无效。
• No data found : 在给定坐标下无法找到任何城市信息。
• API key missing or invalid : API密钥错误或丢失。
• Network error ：网络错误，例如无法连接到服务器。

使用示例 (JavaScript)

fetch('https://api.example.com/geo/city?lat=39.9042&lon=116.4074').then(response => response.json()).then(data => {if (data.status === 'success') {console.log('City:', data.city);console.log('Country:', data.country);} else {console.error('Error:', data.message);}}).catch(error => {
console.error('Network error:', error);});

API 密钥

部分 API 可能需要 API 密钥。请查看 API 文档获取详细信息。

限制

该 API 可能存在调用次数限制，请参考API 文档了解详情。

注意事项

请确保输入的经纬度值准确。API 的精度和效率可能会受到输入数据的影响。

其他

本 API 的具体使用方式和功能可能会根据实际情况而有所调整。 请参考具体的 API 文档。