Opis adresu zawiera dodatkowe informacje, które pomagają opisać lokalizację za pomocą punktów orientacyjnych i obszarów. Aby zapoznać się z tą funkcją, obejrzyj prezentację adresów.
Dodatkowe parametry
Deskryptory adresów można włączyć za pomocą parametru extra_computations
. Aby otrzymać w odpowiedzi opisy adresów, dodaj extra_computations=ADDRESS_DESCRIPTORS
do żądania geokodowania, żądania odwrotnego geokodowania lub żądania geokodowania w usłudze Places.
Przykład geokodowania
To zapytanie zawiera adres miejsca w Delhi:
https://maps.googleapis.com/maps/api/geocode/json?address=4118,+Kalan+Mehal+Chandni+Chowk,+New+Delhi&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY
Przykład geokodowania miejsc
To zapytanie zawiera identyfikator miejsca w Delhi:
https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJyxAX8Bj9DDkRgBfAnBYa66Q&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY
Przykład odwrotnego geokodowania
Poniższe zapytanie zawiera wartość szerokości geograficznej/długości geograficznej lokalizacji w Delhi:
https://maps.googleapis.com/maps/api/geocode/json?latlng=28.640964,77.235875&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY
Odpowiedź
Przykład właściwości address_descriptor
:
{
"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" ]
}
]
}
}
W każdym obiekcie address_descriptor
występują 2 tablice: landmarks
i areas
. Tablica landmarks
zawiera maksymalnie 5 wyników uporządkowanych według trafności z uwzględnieniem bliskości podanych współrzędnych, popularności punktu orientacyjnego i jego widoczności. Każdy wynik dotyczący punktu orientacyjnego zawiera te wartości:
place_id
to identyfikator miejsca w wyniku wyszukiwania punktów orientacyjnych. Zapoznaj się z omówieniem identyfikatora miejsca.display_name
to wyświetlana nazwa punktu orientacyjnego, która zawieralanguage_code
itext
.straight_line_distance_meters
to odległość w metrach między punktem wejściowym a wynikiem z uwzględnieniem punktów orientacyjnych.travel_distance_meters
to odległość w metrach pokonana po sieci drogowej (z pominięciem ograniczeń drogowych) między współrzędnymi wejściowymi a wynikiem z uwzględnieniem punktów orientacyjnych.spatial_relationship
to szacowany związek między współrzędnymi wejściowymi a wynikiem dotyczącym punktów orientacyjnych:"NEAR"
to domyślna relacja, gdy nie ma zastosowania żadna z tych relacji."WITHIN"
, gdy współrzędna wejściowa mieści się w granicach struktury powiązanej z punktem orientacyjnym."BESIDE"
gdy współrzędne wejściowe są bezpośrednio przy zabytku lub punkcie dostępu do zabytku."ACROSS_THE_ROAD"
, gdy współrzędne wejściowe znajdują się po przeciwnej stronie punktu orientacyjnego po drugiej stronie trasy."DOWN_THE_ROAD"
, gdy współrzędna wejściowa znajduje się na tej samej trasie co punkt orientacyjny, ale nie"BESIDES"
ani"ACROSS_THE_ROAD"
."AROUND_THE_CORNER"
gdy współrzędne wejściowe znajdują się na drodze prostopadłej do punktu orientacyjnego (ograniczone do jednego skrętu)."BEHIND"
gdy współrzędne wejściowe znajdują się w pobliżu punktu orientacyjnego, ale daleko od punktu dostępu.types
to typy miejsc związane z miejscem.
Obiekt areas
zawiera maksymalnie 3 odpowiedzi i ogranicza się do miejsc reprezentujących małe regiony, takich jak dzielnice, mniejsze jednostki administracyjne i duże kompleksy. Obszary zawierające podane współrzędne są wymienione jako pierwsze i posortowane od najmniejszego do największego. Każdy wynik areas
zawiera te wartości:
place_id
to identyfikator miejsca w wyniku „areas”. Zapoznaj się z omówieniem identyfikatora miejsca.display_name
to wyświetlana nazwa obszaru, która zawieralanguage_code
itext
.containment
to szacowany związek zasięgu między współrzędnymi wejściowymi a wynikiem obszarów:"NEAR"
to domyślna relacja, gdy nie ma zastosowania żadna z tych relacji."WITHIN"
gdy współrzędna wejściowa jest zbliżona do środka obszaru."OUTSKIRTS"
gdy współrzędna wejściowa znajduje się blisko krawędzi obszaru.
Pokrycie,
Opisy adresów są dostępne we wszystkich regionach. Więcej informacji znajdziesz w sekcji zasięg w poszczególnych regionach.
Prześlij opinię
To jest funkcja w wersji testowej, dlatego prosimy o opinię. Wyślij e-maila na adres address-descriptors-feedback@google.com.