{
"query": {
"lat": 40.4168,
"lon": -3.7038
},
"nearest": {
"geonameId": 6545083,
"name": "Sol",
"latitude": 40.4166,
"longitude": -3.7033,
"countryCode": "ES",
"country": "Spain",
"region": "Madrid",
"population": 8164,
"timezone": "Europe/Madrid",
"type": "neighborhood",
"distanceKm": 0.05
},
"nearestMajorCity": {
"geonameId": 3117735,
"name": "Madrid",
"latitude": 40.4165,
"longitude": -3.7026,
"countryCode": "ES",
"country": "Spain",
"region": "Madrid",
"population": 3255944,
"timezone": "Europe/Madrid",
"type": "capital",
"distanceKm": 0.11
},
"alternatives": [
{
"geonameId": 3117735,
"name": "Madrid",
"latitude": 40.4165,
"longitude": -3.7026,
"countryCode": "ES",
"country": "Spain",
"region": "Madrid",
"population": 3255944,
"timezone": "Europe/Madrid",
"type": "capital",
"distanceKm": 0.11
},
{
"geonameId": 6544494,
"name": "Madrid Centro",
"latitude": 40.4183,
"longitude": -3.7027,
"countryCode": "ES",
"country": "Spain",
"region": "Madrid",
"population": 149718,
"timezone": "Europe/Madrid",
"type": "neighborhood",
"distanceKm": 0.19
},
{
"geonameId": 6545082,
"name": "Las Cortes",
"latitude": 40.4161,
"longitude": -3.6967,
"countryCode": "ES",
"country": "Spain",
"region": "Madrid",
"population": 10816,
"timezone": "Europe/Madrid",
"type": "neighborhood",
"distanceKm": 0.61
},
{
"geonameId": 6545077,
"name": "La Latina",
"latitude": 40.4132,
"longitude": -3.7093,
"countryCode": "ES",
"country": "Spain",
"region": "Madrid",
"population": 10747,
"timezone": "Europe/Madrid",
"type": "neighborhood",
"distanceKm": 0.61
}
],
"attribution": "Place data © GeoNames (https://www.geonames.org), CC BY 4.0."
}
curl --location --request GET 'https://zylalabs.com/api/14234/reverse+geocoding+and+city+search+api/35323/reverse+geocode+coordinates?lat=40.4168&lon=-3.7038&minPopulation=Optional' --header 'Authorization: Bearer YOUR_API_KEY'
{
"query": "Salamanca",
"count": 7,
"results": [
{
"geonameId": 3988214,
"name": "Salamanca",
"latitude": 20.5698,
"longitude": -101.1977,
"countryCode": "MX",
"country": "Mexico",
"region": "Guanajuato",
"population": 160682,
"timezone": "America/Mexico_City"
},
{
"geonameId": 6544491,
"name": "Salamanca",
"latitude": 40.4297,
"longitude": -3.6797,
"countryCode": "ES",
"country": "Spain",
"region": "Madrid",
"population": 147707,
"timezone": "Europe/Madrid"
},
{
"geonameId": 3111108,
"name": "Salamanca",
"latitude": 40.9688,
"longitude": -5.6639,
"countryCode": "ES",
"country": "Spain",
"region": "Castille and León",
"population": 144825,
"timezone": "Europe/Madrid"
},
{
"geonameId": 3872594,
"name": "Salamanca",
"latitude": -31.7792,
"longitude": -70.9639,
"countryCode": "CL",
"country": "Chile",
"region": "Coquimbo Region",
"population": 13265,
"timezone": "America/Santiago"
},
{
"geonameId": 5136088,
"name": "Salamanca",
"latitude": 42.1578,
"longitude": -78.715,
"countryCode": "US",
"country": "United States",
"region": "New York",
"population": 5586,
"timezone": "America/New_York"
},
{
"geonameId": 1690984,
"name": "Salamanca",
"latitude": 10.7465,
"longitude": 123.53,
"countryCode": "PH",
"country": "Philippines",
"region": "Western Visayas",
"population": 4994,
"timezone": "Asia/Manila"
},
{
"geonameId": 3955885,
"name": "Salamanca",
"latitude": -15.5047,
"longitude": -72.8342,
"countryCode": "PE",
"country": "Peru",
"region": "Arequipa",
"population": 547,
"timezone": "America/Lima"
}
],
"attribution": "Place data © GeoNames (https://www.geonames.org), CC BY 4.0."
}
curl --location --request GET 'https://zylalabs.com/api/14234/reverse+geocoding+and+city+search+api/35324/search+places+by+name?q=Salamanca&limit=10' --header 'Authorization: Bearer YOUR_API_KEY'
{
"query": {
"lat": 40.97,
"lon": -5.66,
"radiusKm": 25,
"minPopulation": 1000
},
"count": 10,
"places": [
{
"geonameId": 3111108,
"name": "Salamanca",
"latitude": 40.9688,
"longitude": -5.6639,
"countryCode": "ES",
"country": "Spain",
"region": "Castille and León",
"population": 144825,
"timezone": "Europe/Madrid",
"type": "county seat",
"distanceKm": 0.35
},
{
"geonameId": 3109721,
"name": "Santa Marta de Tormes",
"latitude": 40.9507,
"longitude": -5.6272,
"countryCode": "ES",
"country": "Spain",
"region": "Castille and León",
"population": 14630,
"timezone": "Europe/Madrid",
"type": "seat",
"distanceKm": 3.49
},
{
"geonameId": 3126397,
"name": "Carbajosa de la Sagrada",
"latitude": 40.9331,
"longitude": -5.6503,
"countryCode": "ES",
"country": "Spain",
"region": "Castille and León",
"population": 3467,
"timezone": "Europe/Madrid",
"type": "seat",
"distanceKm": 4.18
},
{
"geonameId": 3104969,
"name": "Villares de la Reina",
"latitude": 41.0083,
"longitude": -5.6488,
"countryCode": "ES",
"country": "Spain",
"region": "Castille and León",
"population": 4079,
"timezone": "Europe/Madrid",
"type": "seat",
"distanceKm": 4.36
},
{
"geonameId": 3127159,
"name": "Cabrerizos",
"latitude": 40.9781,
"longitude": -5.6091,
"countryCode": "ES",
"country": "Spain",
"region": "Castille and León",
"population": 2919,
"timezone": "Europe/Madrid",
"type": "seat",
"distanceKm": 4.37
},
{
"geonameId": 3105411,
"name": "Villamayor",
"latitude": 40.9994,
"longitude": -5.6958,
"countryCode": "ES",
"country": "Spain",
"region": "Castille and León",
"population": 4538,
"timezone": "Europe/Madrid",
"type": "seat",
"distanceKm": 4.44
},
{
"geonameId": 3126968,
"name": "Calvarrasa de Abajo",
"latitude": 40.9464,
"longitude": -5.5526,
"countryCode": "ES",
"country": "Spain",
"region": "Castille and León",
"population": 1003,
"timezone": "Europe/Madrid",
"type": "seat",
"distanceKm": 9.39
},
{
"geonameId": 3108144,
"name": "Terradillos",
"latitude": 40.8384,
"longitude": -5.5416,
"countryCode": "ES",
"country": "Spain",
"region": "Castille and León",
"population": 3232,
"timezone": "Europe/Madrid",
"type": "seat",
"distanceKm": 17.7
},
{
"geonameId": 3130706,
"name": "Alba de Tormes",
"latitude": 40.8266,
"longitude": -5.5124,
"countryCode": "ES",
"country": "Spain",
"region": "Castille and León",
"population": 4881,
"timezone": "Europe/Madrid",
"type": "seat",
"distanceKm": 20.2
},
{
"geonameId": 3104652,
"name": "Villoría",
"latitude": 40.9943,
"longitude": -5.3736,
"countryCode": "ES",
"country": "Spain",
"region": "Castille and León",
"population": 1390,
"timezone": "Europe/Madrid",
"type": "town",
"distanceKm": 24.19
}
],
"attribution": "Place data © GeoNames (https://www.geonames.org), CC BY 4.0."
}
curl --location --request GET 'https://zylalabs.com/api/14234/reverse+geocoding+and+city+search+api/35325/places+within+a+radius?lat=40.97&lon=-5.66&radius=25&minPopulation=1000&limit=20' --header 'Authorization: Bearer YOUR_API_KEY'
注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 反向地理编码和城市搜索 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
| 标头 | 描述 |
|---|---|
授权
|
必需
应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。
|
每个端点返回城市级别的地理编码数据,包括地理坐标、城镇或地区名称、国家代码、人口数据和时区。例如,逆地理编码端点提供基于坐标的最近城镇和主要城市的详细信息
关键字段包括 `geonameId`、`name`、`latitude`、`longitude`、`countryCode`、`country`、`region`、`population`、`timezone` 和 `type` 这些字段提供了关于地点及其特征的重要信息
参数包括用于反向地理编码的 `lat` 和 `lon` 、用于按名称搜索地点的 `query` 和用于查找在指定距离内的地点的 `radiusKm` 用户还可以指定 `minPopulation` 以根据人口规模筛选结果
响应数据采用JSON格式结构,其中包含一个主要的`query`对象,后面是相关的数据部分,如`nearest`、`nearestMajorCity`和`places`。每个部分包含关于返回位置的详细属性
数据来自一个涵盖全球171,000个地点的综合数据库。它结合了地理、人口和行政信息以确保准确性和相关性
典型的用例包括基于位置的服务 旅行应用程序 城市规划和地理分析 开发人员可以使用API通过提供特定位置的信息来增强用户体验
用户可以通过将返回的数据集成到应用程序中来进行地图绘制、位置搜索或人口分析。例如,`timezone`字段可以帮助根据当地时间安排活动
如果结果是部分的或空的,用户应检查输入参数的准确性。实现备用逻辑,如建议附近地点或替代查询,可以在数据有限时提高用户体验