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

}