Adressbeschreibungen enthalten zusätzliche Informationen zur Beschreibung eines Standorts. mit Orientierungspunkten und Bereichen. Sehen Sie sich die Demo zu Adressdeskriptoren an. um die Funktion zu erkunden.
Zusätzliche Parameter
Adressdeskriptoren können mithilfe der extra_computations
aktiviert werden
. extra_computations=ADDRESS_DESCRIPTORS
in eine Geocoding-Anfrage einfügen
, umgekehrte Geocoding-Anfrage
oder eine Places-Geocoding-Anfrage
um Beschreibungen der Adresse in Ihrer Antwort zu erhalten.
Beispiel für die Geocodierung
Die folgende Abfrage enthält die Adresse eines Ortes in 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
Beispiel für das Geocoding von Orten
Die folgende Abfrage enthält die Orts-ID eines Ortes in Delhi:
https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJyxAX8Bj9DDkRgBfAnBYa66Q&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY
Beispiel für umgekehrte Geocodierung
Die folgende Abfrage enthält den Breiten-/Längengradwert für einen Standort in Delhi:
https://maps.googleapis.com/maps/api/geocode/json?latlng=28.640964,77.235875&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY
Antwort
Hier ein Beispiel für 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" ]
}
]
}
}
In jedem address_descriptor
-Objekt gibt es zwei Arrays: landmarks
und
areas
Das Array landmarks
enthält bis zu 5 Ergebnisse in der Reihenfolge
Relevanz unter Berücksichtigung der Nähe zur angeforderten Koordinate,
die Verbreitung der Sehenswürdigkeit und ihre Sichtbarkeit. Jedes Markierungsergebnis enthält die
folgende Werte:
place_id
ist die Orts-ID des Ergebnisses für Sehenswürdigkeiten. Sehen Sie sich die Orts-ID an. Übersicht.display_name
ist der Anzeigename der Sehenswürdigkeit und enthältlanguage_code
undtext
.straight_line_distance_meters
ist die Entfernung zwischen der Eingabekoordinate und dem Ergebnis der Orientierungspunkte in Metern.travel_distance_meters
ist die Entfernung in Metern zwischen der Eingabekoordinate und dem Ergebnis der Sehenswürdigkeiten, die auf dem Straßennetz ohne Berücksichtigung von Straßeneinschränkungen zurückgelegt wurde.spatial_relationship
ist die geschätzte Beziehung zwischen der Eingabekoordinate und dem Ergebnis der Orientierungspunkte:"NEAR"
ist die Standardbeziehung, wenn keiner der folgenden Punkte zutrifft."WITHIN"
, wenn die Eingabekoordinate innerhalb der Grenzen des mit der Sehenswürdigkeit verknüpften Gebäudes liegt."BESIDE"
, wenn die Eingabekoordinate direkt neben dem Zugangspunkt der Sehenswürdigkeit oder Sehenswürdigkeit liegt."ACROSS_THE_ROAD"
, wenn die Eingabekoordinate der Sehenswürdigkeit auf der anderen Seite der Route direkt gegenüber liegt."DOWN_THE_ROAD"
, wenn die Eingabekoordinate auf derselben Route wie die Sehenswürdigkeit liegt, aber nicht"BESIDES"
oder"ACROSS_THE_ROAD"
."AROUND_THE_CORNER"
, wenn die Eingabekoordinate entlang einer senkrechten Route als Orientierungspunkt liegt (auf eine einzige Abbiegung beschränkt)."BEHIND"
, wenn die Eingabekoordinate räumlich nahe an der Sehenswürdigkeit, aber weit von ihrem Zugangspunkt entfernt ist.types
sind die Ortstypen der Sehenswürdigkeit.
Das areas
-Objekt enthält bis zu drei Antworten und ist auf Stellen beschränkt,
kleine Regionen wie Stadtteile, Unterortsteile und große
komplex. Gebiete, die die angeforderten Koordinaten enthalten, werden zuerst aufgeführt und
vom Kleinsten zum größten sortiert. Jedes areas
-Ergebnis enthält Folgendes:
Werte:
place_id
ist die Orts-ID der Ergebnisergebnisse. Sehen Sie sich die Orts-ID an. Übersicht.display_name
ist der Anzeigename des Bereichs und enthältlanguage_code
undtext
.containment
ist die geschätzte Begrenzungsbeziehung zwischen der Eingabekoordinate und dem Ergebnis der Fläche:"NEAR"
ist die Standardbeziehung, wenn keiner der folgenden Punkte zutrifft."WITHIN"
, wenn die Eingabekoordinate nahe am Mittelpunkt des Gebiets liegt."OUTSKIRTS"
, wenn die Eingabekoordinate nahe am Rand des Bereichs liegt.
Abdeckung
Diese Funktion ist nur in ausgewählten Ländern verfügbar.
Feedback
Dies ist eine Funktion in der Vorabversion und wir würden uns über Ihr Feedback freuen. E-Mail senden senden Sie uns eine E-Mail an address-descriptors-feedback@google.com.