{
"mode": "forward",
"query": {
"q": "Eiffel Tower",
"limit": 1,
"country": null
},
"count": 1,
"results": [
{
"lat": 48.8582599,
"lon": 2.2945006,
"display_name": "Eiffel Tower, 5, Avenue Anatole France, Quartier du Gros-Caillou, 7th Arrondissement, Paris, Ile-de-France, Metropolitan France, 75007, France",
"name": "Eiffel Tower",
"category": "man_made",
"type": "tower",
"address": {
"house_number": "5",
"road": "Avenue Anatole France",
"postcode": "75007",
"city": "Paris",
"county": null,
"state": "Ile-de-France",
"country": "France",
"country_code": "FR"
},
"bbox": [
48.8574753,
48.8590453,
2.2933119,
2.2956897
],
"importance": 0.621
}
],
"sources": [
{
"name": "Open geographic data",
"license": "ODbL 1.0"
}
]
}
curl --location --request GET 'https://zylalabs.com/api/14582/geocoding+and+reverse+geocoding+api/37362/geocode?q=Eiffel Tower' --header 'Authorization: Bearer YOUR_API_KEY'
注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 地理编码和反向地理编码 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
| 标头 | 描述 |
|---|---|
授权
|
必需
应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。
|
地理编码端点返回的数据包括地理坐标(纬度和经度)、结构化地址、显示名称、类别、类型以及查询位置的边界框
响应中的关键字段包括“lat”和“lon”用于坐标,“display_name”用于完整地址,“name”用于地点名称,“category”用于地点类型,以及“address”用于结构化地址组件
用户可以使用参数自定义请求,如“q”用于地址或地点名称,“limit”指定结果数量,以及“country”按特定国家过滤结果
响应数据被组织成一个JSON结构,其中包含一个指示查询类型的“mode”字段,一个详细说明输入参数的“query”对象,一个结果数量的“count”字段,以及一个包含单个位置数据的“results”数组
数据来源于各种地理数据库和制图服务,确保全球位置的全面和准确的 representation
典型的用例包括地图应用程序、基于位置的服务、地址验证和地理分析,使用户能够将地址转换为坐标,反之亦然
用户可以通过提取特定字段,如用于映射的坐标、用于显示的结构化地址或用于区域计算的边界框,来利用返回的数据在他们的应用程序中。
如果结果为部分或为空,用户应检查输入参数的准确性,考虑扩展搜索条件,或实现回退逻辑以处理未找到匹配项的情况