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

}