Adressdeskriptoren enthalten zusätzliche Informationen, mit denen ein Standort mithilfe von Sehenswürdigkeiten und Bereichen beschrieben wird. In der Demo zu Adressbeschreibungen können Sie sich die Funktion ansehen.
Zusätzliche Parameter
Adressbeschreibungen können mit dem Parameter extra_computations aktiviert werden. Fügen Sie extra_computations=ADDRESS_DESCRIPTORS in eine Geocoding-Anfrage, eine umgekehrte Geocoding-Anfrage oder eine Geocoding-Anfrage für Orte ein, um Adressbeschreibungen in Ihrer Antwort zu erhalten.
Beispiel für die Geocodierung
Die folgende Abfrage enthält die Adresse eines Orts 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 Geocodieren von Orten
Die folgende Abfrage enthält die Orts-ID eines Orts 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ängengrad für einen Ort in Delhi:
https://maps.googleapis.com/maps/api/geocode/json?latlng=28.640964,77.235875&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY
Antwort
Ein Beispiel für address_descriptor sieht so aus:
{
"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 fünf Ergebnisse, die nach Relevanz sortiert sind. Dabei werden die Nähe zur angeforderten Koordinate, die Verbreitung der Sehenswürdigkeit und ihre Sichtbarkeit berücksichtigt. Jedes Ergebnis für Markierungen enthält die folgenden Werte:
place_idist die Orts-ID des Ergebnisses für Sehenswürdigkeiten. Weitere Informationen finden Sie unter Orts-IDs.display_nameist der Anzeigename des Wahrzeichens und enthältlanguage_codeundtext.straight_line_distance_metersist die Entfernung zwischen den Punkten in Metern zwischen der Eingabekoordinate und dem Ergebnis für Markierungen.travel_distance_metersist 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_relationshipist die geschätzte Beziehung zwischen der Eingabekoordinate und dem Ergebnis der Orientierungspunkte:"NEAR"ist die Standardbeziehung, wenn keines der folgenden Kriterien zutrifft."WITHIN", wenn sich die Eingabekoordinate innerhalb der Grenzen des Gebäudes befindet, das mit dem Wahrzeichen verknüpft ist."BESIDE", wenn die Eingabekoordinate direkt neben dem Wahrzeichen oder dem Zugangspunkt des Wahrzeichens liegt."ACROSS_THE_ROAD", wenn sich die Eingabekoordinate direkt gegenüber dem Wahrzeichen auf der anderen Seite der Route befindet."DOWN_THE_ROAD", wenn sich die Eingabekoordinate auf derselben Route wie das Wahrzeichen befindet, aber nicht"BESIDES"oder"ACROSS_THE_ROAD"."AROUND_THE_CORNER", wenn sich die Eingabekoordinate entlang einer senkrechten Route wie das Wahrzeichen befindet (auf eine einzige Abbiegung beschränkt)."BEHIND", wenn sich die Eingabekoordinaten zwar in der Nähe des Wahrzeichens, aber weit vom Zugangspunkt entfernt befinden.typessind die Ortstypen der Sehenswürdigkeit.
Das areas-Objekt enthält bis zu drei Antworten und beschränkt sich auf Orte, die kleine Regionen darstellen, z. B. Stadtteile, Ortsteile und große Komplexe. Die Gebiete, die die angeforderten Koordinaten enthalten, werden zuerst aufgeführt und vom kleinsten zum größten sortiert. Jedes areas-Ergebnis enthält die folgenden Werte:
place_idist die Orts-ID des Ergebnisses für „Orte“. Weitere Informationen finden Sie unter Orts-IDs.display_nameist der Anzeigename des Gebiets und enthältlanguage_codeundtext.containmentist das geschätzte Begrenzungsverhältnis zwischen der Eingabekoordinate und dem Ergebnis für die Bereiche:"NEAR"ist die Standardbeziehung, wenn keines der folgenden Kriterien zutrifft."WITHIN", wenn sich die Eingabekoordinate nahe dem Zentrum des Gebiets befindet."OUTSKIRTS", wenn sich die Eingabekoordinate nahe am Rand des Gebiets befindet.
Abdeckung
Adressbeschreibungen sind in allen Regionen verfügbar. Weitere Informationen finden Sie unter Abdeckung.
Feedback
Dies ist eine Funktion in der Vorabversion und wir würden uns über Ihr Feedback freuen. Bitte senden Sie eine E-Mail an address-descriptors-feedback@google.com.