GET/locationsДовідники

Локації, регіони, райони та населені пункти

Регіони, райони та населені пункти з фільтрацією за країною і батьківською локацією.

feature_class=A&feature_code=ADM1 повертає регіони, ADM2 — райони, а feature_class=P — міста й села.
Невідома країна або комбінація фільтрів повертає порожній список, а не 404.
Пагінація через after_id, як у /countries.

Параметри запиту

querystring≤ 200 chars

Необов'язковий пошук за буквальним префіксом назви. Для країн пошук також охоплює власні назви, коди ISO та збережені переклади. Порожній текст вимикає цей фільтр.

ids[]integer[]≥ 1 · ≤ 100 items

Пакетний пошук. Повторюйте ids[]=2001&ids[]=3001; не рядок через кому. Невідомі ID пропускаються. Застосовується разом з іншими фільтрами.

per_pageinteger1–1,000 · default 100

Максимальна кількість записів у відповіді. Порожні, нецілочислові або поза діапазоном значення повертають 422.

after_idinteger≥ 1

Курсор за ID (не включно). Спочатку не передавайте; далі використовуйте meta.next_after_id з незмінними фільтрами. Це не номер сторінки. Порожні або недодатні значення повертають 422.

country_idinteger≥ 1

Внутрішній ID країни з /countries. Необов'язковий; не передавайте, щоб перебрати всі країни.

admin1integer≥ 1

ID адміністративної локації першого рівня, а не ID країни чи код джерела.

admin2integer≥ 1

ID адміністративної локації другого рівня.

feature_classstring

Клас джерела без урахування регістру: A для адміністративних одиниць, P для населених пунктів (не лише міст). Невідомі коректно сформовані значення повертають порожній список.

feature_codestring

Код джерела без урахування регістру: ADM1 для регіонів, ADM2 для районів. Невідомі коректно сформовані значення повертають порожній список.

langstring

Локаль відповіді. Переклади опцій також обмежено мовами акаунта. Сторінка автоматично обирає поточну мову.

Повертає · Об'єкти Location у data з тим самим meta, що й у /countries.

GET/locations

curl -g "https://api.lotarius.com/locations?api_key=$CARS_API_KEY" \
  -H "Accept: application/json"

ПрикладиЗаписано

{2 keys

"data": [1 item

0: {15 keys

"id": 1841610

"name": "Kyunggi-do"

"original_name": "Gyeonggi-do"

"ascii_name": null

"country_id": 208

"admin1": 1841610

"admin2": null

"population": 13413459

"admin3": null

"admin4": null

"admin5": null

"feature_class": "A"

"feature_code": "ADM1"

"latitude": 37.6

"longitude": 127.25

}

]

"meta": {3 keys

}