CarStat.dev
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 id z name: null. Etykieta tekstowa ze źródła ma id: null.
  • Region może być jednocześnie miejscowością (to samo ID dwukrotnie, jak w przykładzie). Usuwaj duplikaty etykiet po ID.
  • place to obiekt geograficzny, nie zawsze miasto. Nigdy nie wyznaczamy miasta na podstawie współrzędnych.
  • Starsze pole location zachowano dla zgodności. Jego wartości to ID w /search i 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"