Deskryptory adresów zwracają dodatkowe informacje do standardowej odpowiedzi odwrotnej geokodowania, która pomaga opisywać współrzędne szerokości i długości geograficznej za pomocą punktów orientacyjnych i obszarów. Aby poznać interfejs API, zapoznaj się z prezentacją deskryptorów adresów.
Żądania odwrotnego geokodowania – parametry dodatkowe
Parametry opcjonalne
Oto opcjonalne parametry, które możesz uwzględnić w żądaniu odwrotnego geokodowania:
enable_address_descriptor– parametr logiczny, który ma być uwzględniany w żądaniu odwrotnego geokodowania w celu dodania deskryptora adresu do standardowej odpowiedzi odwrotnej geokodowania.
Przykład odwrotnego geokodowania
To zapytanie zawiera szerokość i długość geograficzną lokalizacji w Delhi:
https://maps.googleapis.com/maps/api/geocode/json?latlng=28.640964,77.235875&key=YOUR_API_KEY&enable_address_descriptor=true
Odpowiedź
To zapytanie zwraca dodatkowy obiekt address_descriptor w taki sposób:
{
"address_descriptor" : {
"areas" : [
{
"containment" : "OUTSKIRTS",
"display_name" : {
"language_code" : "en",
"text" : "Turkman Gate"
},
"place_id" : "ChIJ_7LLvyb9DDkRMKKxP9YyXgs"
},
{
"containment" : "OUTSKIRTS",
"display_name" : {
"language_code" : "en",
"text" : "Chandni Chowk"
},
"place_id" : "ChIJWcXciBr9DDkRUb4dCDykTwI"
},
{
"containment" : "NEAR",
"display_name" : {
"language_code" : "en",
"text" : "Katar Ganj"
},
"place_id" : "ChIJH3cWUyH9DDkRaw-9CjvcRvY"
}
],
"landmarks" : [
{
"display_name" : {
"language_code" : "en",
"text" : "Delite Cinema"
},
"straight_line_distance_meters" : 29.9306755065918,
"place_id" : "ChIJLfiYDCT9DDkROoEa7NdupUM",
"travel_distance_meters" : 418.7794799804688,
"spatial_relationship" : "ACROSS_THE_ROAD",
"types" : [ "establishment", "movie_theater", "point_of_interest" ]
},
{
"display_name" : {
"language_code" : "en",
"text" : "YES Bank"
},
"straight_line_distance_meters" : 66.83731079101562,
"place_id" : "ChIJFYHM3yb9DDkRRKGkZl2mpSQ",
"travel_distance_meters" : 489.0340270996094,
"spatial_relationship" : "DOWN_THE_ROAD",
"types" : [ "bank", "establishment", "finance", "point_of_interest" ]
},
{
"display_name" : {
"language_code" : "en",
"text" : "UCO Bank"
},
"straight_line_distance_meters" : 25.38849639892578,
"place_id" : "ChIJ-c6_wCb9DDkRjIk1LeqRtGM",
"travel_distance_meters" : 403.2246398925781,
"spatial_relationship" : "ACROSS_THE_ROAD",
"types" : [ "atm", "bank", "establishment", "finance", "point_of_interest" ]
},
{
"display_name" : {
"language_code" : "en",
"text" : "Delhi By Cycle Meeting Point"
},
"straight_line_distance_meters" : 44.02867126464844,
"place_id" : "ChIJNxVfkSb9DDkRJD22l-eGFdM",
"travel_distance_meters" : 97.41281890869141,
"spatial_relationship" : "AROUND_THE_CORNER",
"types" : [
"establishment",
"point_of_interest",
"tourist_attraction",
"travel_agency"
]
},
{
"display_name" : {
"language_code" : "en",
"text" : "Axis Bank Branch"
},
"straight_line_distance_meters" : 102.3495178222656,
"place_id" : "ChIJr3uaDCT9DDkR8roHTVSn1x4",
"travel_distance_meters" : 330.8566284179688,
"spatial_relationship" : "DOWN_THE_ROAD",
"types" : [ "bank", "establishment", "finance", "point_of_interest" ]
}
]
},
... Results (reverse geocoding response) ...
Każdy obiekt address_descriptor zawiera 2 tablice: landmarks i areas. Tablica landmarks zawiera maksymalnie 5 wyników uporządkowanych według trafności, biorąc pod uwagę odległość od żądanej współrzędnych, powszechność użycia punktu orientacyjnego i jego widoczność. Każdy wynik z punktów orientacyjnych zawiera te wartości:
place_idto identyfikator miejsca znalezionego w wynikach wyszukiwania punktów orientacyjnych. Przeczytaj omówienie identyfikatora miejsca.display_nameto wyświetlana nazwa punktu orientacyjnego, która zawiera nazwylanguage_codeitext.straight_line_distance_metersto odległość między punktami do punktu w metrach między współrzędną wejściową a wynikiem punktów orientacyjnych.travel_distance_metersto odległość (w metrach) pokonana przez sieć dróg (z pominięciem ograniczeń dotyczących dróg) między współrzędną wejściową a wynikiem punktu orientacyjnego.spatial_relationshipto szacowana zależność między współrzędną wejściową a wynikiem punktów orientacyjnych:- Relacja domyślna:
"NEAR", gdy nie ma zastosowania żaden z poniższych warunków. "WITHIN", gdy współrzędna wejściowa znajduje się w granicach struktury powiązanej z punktem orientacyjnym."BESIDE", gdy współrzędne wejściowe przylegają bezpośrednio do punktu dostępu do punktu orientacyjnego."ACROSS_THE_ROAD", gdy współrzędna wejściowa jest naprzeciwko punktu orientacyjnego po drugiej stronie trasy."DOWN_THE_ROAD", gdy współrzędna wejściowa znajduje się wzdłuż tej samej trasy co punkt orientacyjny, ale nie"BESIDES"ani"ACROSS_THE_ROAD"."AROUND_THE_CORNER", gdy wejściowa współrzędna przebiega wzdłuż prostopadłej trasy jako punkt orientacyjny (ograniczone do jednego skrętu)."BEHIND", gdy współrzędna wejściowa jest przestrzennie blisko punktu orientacyjnego, ale daleko od jego punktu dostępu.typesto typy miejsc danego punktu orientacyjnego.
Obiekt areas zawiera do 3 odpowiedzi i ogranicza się do miejsc reprezentujących małe regiony, np. dzielnice, podrejony i duże kompleksy. Obszary zawierające żądaną współrzędną są wymienione jako pierwsze i uporządkowane od najmniejszej do największej. Każdy wynik areas zawiera te wartości:
place_idto identyfikator miejsca w wynikach wyszukiwania obszarów. Przeczytaj omówienie identyfikatora miejsca.display_nameto wyświetlana nazwa obszaru, która zawieralanguage_codeitext.containmentto szacowana zależność między współrzędną wejściową a wynikiem obszarów:- Relacja domyślna:
"NEAR", gdy nie ma zastosowania żaden z poniższych warunków. "WITHIN", gdy współrzędna wejściowa jest blisko środka obszaru."OUTSKIRTS", gdy współrzędna wejściowa jest blisko krawędzi obszaru.
Pokrycie,
Ta funkcja jest dostępna tylko w wybranych krajach.
Prześlij opinię
Jest to funkcja eksperymentalna i chętnie poznamy Twoją opinię. Wyślij nam e-maila na adres address-descriptors-feedback@google.com.