GET/locationsSłowniki

Lokalizacje, regiony, powiaty i miejscowości

Regiony, powiaty i miejscowości, z filtrowaniem po kraju i jednostce nadrzędnej.

feature_class=A&feature_code=ADM1 zwraca regiony, ADM2 powiaty, a feature_class=P miasta i wsie.
Nieznany kraj lub kombinacja filtrów zwraca pustą listę, a nie 404.
Stronicowanie przez after_id, jak w /countries.

Parametry zapytania

querystring≤ 200 chars

Opcjonalne dosłowne wyszukiwanie po prefiksie nazwy. Dla krajów przeszukiwane są też nazwy natywne, kody ISO i zapisane tłumaczenia. Pusty tekst wyłącza ten filtr.

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

Pobieranie zbiorcze. Powtarzaj ids[]=2001&ids[]=3001; nie jako ciąg rozdzielony przecinkami. Nieznane ID są pomijane. Łączy się z innymi filtrami.

per_pageinteger1–1,000 · default 100

Maksymalna liczba zwracanych rekordów. Puste, niecałkowite lub spoza zakresu wartości zwracają 422.

after_idinteger≥ 1

Wyłączny kursor ID. Na początku pomiń; następnie używaj meta.next_after_id z niezmienionymi filtrami. To nie jest numer strony. Puste lub niedodatnie wartości zwracają 422.

country_idinteger≥ 1

Wewnętrzne ID kraju z /countries. Opcjonalne; pomiń, aby wyliczyć wszystkie kraje.

admin1integer≥ 1

ID lokalizacji administracyjnej pierwszego poziomu, nie ID kraju ani kod źródła.

admin2integer≥ 1

ID lokalizacji administracyjnej drugiego poziomu.

feature_classstring

Klasa źródła, bez rozróżniania wielkości liter: A dla obszarów administracyjnych, P dla miejscowości (nie tylko miast). Nieznane, ale poprawnie sformułowane wartości zwracają pustą listę.

feature_codestring

Kod źródła, bez rozróżniania wielkości liter: ADM1 dla regionów, ADM2 dla powiatów. Nieznane, ale poprawnie sformułowane wartości zwracają pustą listę.

langstring

Język odpowiedzi. Tłumaczenia opcji są dodatkowo ograniczone do języków konta. Strona automatycznie wybiera bieżący język.

Zwraca · Obiekty Location w data, z tym samym meta co /countries.

GET/locations

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

PrzykładyNagrane

{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

}