База городов и стран мира
7 континентов, 247 стран, 231 216 округов, 4 622 511 города мира на 182 языках, включая английский, немецкий, французский, польский, голландский, русский, испанский, итальянский, китайский, португальский и др.
{
"id": "5325423",
"name": "Azusa",
"latitude": 34.13362,
"longitude": -117.90756,
"type": "city",
"continentCode": "NA",
"countryCode": "US",
"division1Code": "CA",
"division2Code": "037",
"division3Code": null,
"division4Code": null,
"population": "49690",
"timezone": "America/Los_Angeles",
"parentRegions": [
{
"id": "5368381",
"name": "Los Angeles"
},
{
"id": "5332921",
"name": "California"
},
{
"id": "6252001",
"name": "United States"
},
{
"id": "6255149",
"name": "North America"
}
]
}Получайте список городов и стран
Метод `regions` возвращает континенты, страны, округа и города. Вы можете запросить как список всех городов мира, так и только те города, находятся внутри определенной страны или округа.
Подробнее{
"edges": [
{
"node": {
"id": "451747",
"name": "Zyabrikovo",
"latitude": 56.84665,
"longitude": 34.7048,
"type": "city",
"continentCode": "EU",
"countryCode": "RU",
"division1Code": "77",
"division2Code": null,
"division3Code": null,
"division4Code": null,
"population": "0",
"timezone": "Europe/Moscow",
"parentRegions": [
{
"id": "480041",
"name": "Tver Oblast"
},
{
"id": "2017370",
"name": "Russia"
},
{
"id": "6255148",
"name": "Europe"
}
]
},
"cursor": "Y29ubjo0NTE3NDc"
},
{
"node": {
"id": "451748",
"name": "Znamenka",
"latitude": 56.74087,
"longitude": 34.02323,
"type": "city",
"continentCode": "EU",
"countryCode": "RU",
"division1Code": "77",
"division2Code": null,
"division3Code": null,
"division4Code": null,
"population": "0",
"timezone": "Europe/Moscow",
"parentRegions": [
{
"id": "480041",
"name": "Tver Oblast"
},
{
"id": "2017370",
"name": "Russia"
},
{
"id": "6255148",
"name": "Europe"
}
]
},
"cursor": "Y29ubjo0NTE3NDg"
}
],
"pageInfo": {
"hasNextPage": true,
"hasPreviousPage": false,
"startCursor": "Y29ubjo0NTE3NDc",
"endCursor": "Y29ubjo0NTE3NDg"
}
}Получайте все регионы внутри заданного
Используя метод `childRegions`, реализуйте на своем сайте удобный выбор города для пользователя: в начале он выберет свою страну, затем округ, а затем город.
Если на вашем сайте показываются результаты поиска с привязкой к региону (напр, список анкет на сайте знакомств), то вы можете внизу своих страниц добавить список дочерних регионов, чтобы пользователь смог уточнить свой поиск.
Подробнее{
"edges": [
{
"node": {
"id": "2822542",
"name": "Free State of Thuringia",
"latitude": 50.91667,
"longitude": 11,
"type": "division1",
"continentCode": "EU",
"countryCode": "DE",
"division1Code": "15",
"division2Code": null,
"division3Code": null,
"division4Code": null,
"population": "2249882",
"timezone": "Europe/Berlin",
"parentRegions": [
{
"id": "2921044",
"name": "Germany"
},
{
"id": "6255148",
"name": "Europe"
}
]
},
"cursor": "Y29ubjoyODIyNTQy"
},
{
"node": {
"id": "2838632",
"name": "Schleswig-Holstein",
"latitude": 54.2,
"longitude": 9.75,
"type": "division1",
"continentCode": "EU",
"countryCode": "DE",
"division1Code": "10",
"division2Code": null,
"division3Code": null,
"division4Code": null,
"population": "2832027",
"timezone": "Europe/Berlin",
"parentRegions": [
{
"id": "2921044",
"name": "Germany"
},
{
"id": "6255148",
"name": "Europe"
}
]
},
"cursor": "Y29ubjoyODM4NjMy"
}
],
"pageInfo": {
"hasNextPage": false,
"hasPreviousPage": false,
"startCursor": "Y29ubjoyODIyNTQy",
"endCursor": "Y29ubjoyODM4NjMy"
}
}Находите регионы по поисковому запросу
Предоставьте пользователю возможность быстро найти свой регион по поисковой фразе. Метод `searchRegions` находит все виды регионов (континенты, страны, округа, города) по их названию на одном из 182 языков мира. При необходимости, сузьте поиск до определенной страны или округа.
Подробнее[
{
"id": "8878031",
"name": "La Higuera Caída",
"latitude": 25.60333,
"longitude": -107.66139,
"type": "city",
"continentCode": "NA",
"countryCode": "MX",
"division1Code": "25",
"division2Code": "013",
"division3Code": null,
"division4Code": null,
"population": "125",
"timezone": "America/Mazatlan",
"parentRegions": [
{
"id": "8583359",
"name": "Mocorito"
},
{
"id": "3983035",
"name": "Sinaloa"
},
{
"id": "3996063",
"name": "Mexico"
},
{
"id": "6255149",
"name": "North America"
}
]
},
{
"id": "8561495",
"name": "Higashiyama",
"latitude": 40.41918,
"longitude": 141.37226,
"type": "city",
"continentCode": "AS",
"countryCode": "JP",
"division1Code": "03",
"division2Code": "2128302",
"division3Code": "02445",
"division4Code": null,
"population": "0",
"timezone": "Asia/Tokyo",
"parentRegions": [
{
"id": "2129009",
"name": "Nambu"
},
{
"id": "2128302",
"name": "Sannohe Gun"
},
{
"id": "2130656",
"name": "Aomori"
},
{
"id": "1861060",
"name": "Japan"
},
{
"id": "6255147",
"name": "Asia"
}
]
}
]Находите ближайшие регионы
Используя метод `nearestRegions`, покажите пользователю список ближайших к нему городов, чтобы он мог быстро уточнить или изменить критерии поиска. Например, вы можете предложить пользователю вакансии, анкеты или специалистов из соседних городов.
Подробнее[
{
"id": "321580",
"name": "Belek",
"latitude": 36.86278,
"longitude": 31.05556,
"type": "city",
"continentCode": "AS",
"countryCode": "TR",
"division1Code": "07",
"division2Code": null,
"division3Code": null,
"division4Code": null,
"population": "73260",
"timezone": "Europe/Istanbul",
"parentRegions": [
{
"id": "323776",
"name": "Antalya"
},
{
"id": "298795",
"name": "Turkey"
},
{
"id": "6255147",
"name": "Asia"
}
]
},
{
"id": "8073419",
"name": "Eminciler",
"latitude": 36.89228,
"longitude": 31.05652,
"type": "city",
"continentCode": "AS",
"countryCode": "TR",
"division1Code": "07",
"division2Code": null,
"division3Code": null,
"division4Code": null,
"population": "0",
"timezone": "Europe/Istanbul",
"parentRegions": [
{
"id": "323776",
"name": "Antalya"
},
{
"id": "298795",
"name": "Turkey"
},
{
"id": "6255147",
"name": "Asia"
}
]
}
]Определяйте регион по IP-адресу
Определяйте при помощи метода `network` примерное местоложение пользователя и регион, в котором он находится. Если на вашем сайте есть региональные страницы, вы можете автоматически перенаправить пользователя на нужную страницу.
Подробнее{
"id": "TmV0d29yazo5MTEwMw",
"network": "23.35.212.0/22",
"latitude": 38.1302,
"longitude": 13.329,
"accuracyRadius": 1000,
"region": {
"id": "2523920",
"name": "Palermo",
"latitude": 38.13205,
"longitude": 13.33561,
"type": "city",
"continentCode": "EU",
"countryCode": "IT",
"division1Code": "15",
"division2Code": "PA",
"division3Code": "082053",
"division4Code": null,
"population": "648260",
"timezone": "Europe/Rome",
"parentRegions": [
{
"id": "6542127",
"name": "Palermo"
},
{
"id": "2523918",
"name": "Province of Palermo"
},
{
"id": "2523119",
"name": "Sicily"
},
{
"id": "3175395",
"name": "Italy"
},
{
"id": "6255148",
"name": "Europe"
}
]
}
}Показывайте регионы на языке пользователя
В базе хранятся названия регионов на многих языках мира, включая английский, немецкий, французский, польский, голландский, русский, испанский, итальянский, китайский, португальский и др.
Язык пользователя определяется автоматически, что позволит вашим пользователям видеть названия регионов на своем родном языке. При необходимости его можно задать вручную.
Документация