Ръководство
Показване на местоположението на обява
Всяка обява има 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"