CarStat.dev
Ръководство

Показване на местоположението на обява

Всяка обява има 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"