Посібник

Відображення локації оголошення

Кожне оголошення має location_details з однаковими чотирма частинами на всіх ендпоінтах: country як {id, name, iso}, а region, district і place як {id, name}. Відсутні частини мають значення null. Беріть назви звідси напряму; додаткові запити не потрібні.

ID, який не вдалося розпізнати, зберігає свій id з name: null. Текстова назва від джерела має id: null.
Регіон може водночас бути населеним пунктом (той самий ID двічі, як у прикладі). Прибирайте дублікати назв за ID.
place — це географічний запис, не завжди місто. Ми ніколи не визначаємо місто за координатами.
Старіше поле location збережено для сумісності. Його значення — ID у /search і локалізовані рядки в /cars; не використовуйте його в новому коді.

Створення списків вибору регіону та міста

Для інтерфейсів фільтрів використовуйте довідники. Завантажте /countries, потім регіони через /locations?country_id=C&feature_class=A&feature_code=ADM1, райони через admin1=R&feature_code=ADM2, а міста — через feature_class=P. Пагінація через after_id. Результати впорядковано за ID, а не за релевантністю, тож сортуйте за назвою у своєму інтерфейсі.

listings[0].location_detailsНаживо

{
  "country": {
    "id": 208,
    "name": "South Korea",
    "iso": "KR"
  },
  "region": {
    "id": 1841610,
    "name": "Gyeonggi-do"
  },
  "district": null,
  "place": {
    "id": 1841610,
    "name": "Gyeonggi-do"
  }
}

Регіони Південної Кореї

curl -g "https://api.lotarius.com/locations?country_id=208&feature_class=A&feature_code=ADM1&lang=en&api_key=$CARS_API_KEY" \
  -H "Accept: application/json"