Przewodnik
Wyświetlanie lokalizacji ogłoszenia
Każde ogłoszenie ma location_details z tymi samymi czterema częściami w każdym endpoincie: country jako {id, name, iso} oraz region, district i place jako {id, name}. Brakujące części mają wartość null. Odczytuj nazwy bezpośrednio stąd; dodatkowe żądania nie są potrzebne.
- ID, którego nie udało się rozwiązać, zachowuje swoje
idzname: null. Etykieta tekstowa ze źródła maid: null. - Region może być jednocześnie miejscowością (to samo ID dwukrotnie, jak w przykładzie). Usuwaj duplikaty etykiet po ID.
placeto obiekt geograficzny, nie zawsze miasto. Nigdy nie wyznaczamy miasta na podstawie współrzędnych.- Starsze pole
locationzachowano dla zgodności. Jego wartości to ID w/searchi lokalizowane ciągi w/cars; unikaj go w nowym kodzie.
Budowanie selektorów regionu i miasta
W UI filtrów korzystaj ze słowników. Załaduj /countries, następnie regiony przez /locations?country_id=C&feature_class=A&feature_code=ADM1, powiaty przez admin1=R&feature_code=ADM2, a miejscowości przez feature_class=P. Stronicuj za pomocą after_id. Wyniki są uporządkowane według ID, a nie trafności, więc sortuj po nazwie w swoim UI.
listings[0].location_detailsNa żywo
{
"country": {
"id": 208,
"name": "South Korea",
"iso": "KR"
},
"region": {
"id": 1841610,
"name": "Gyeonggi-do"
},
"district": null,
"place": {
"id": 1841610,
"name": "Gyeonggi-do"
}
}Regiony Korei Południowej
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"