Anfrage und Antwort für Adressdeskriptoren

Adressbeschreibungen enthalten zusätzliche Informationen, die dazu beitragen, einen Ort anhand von Sehenswürdigkeiten und Gebieten zu beschreiben. In der Demo zu Adressbeschreibungen können Sie sich die Funktion ansehen.

Zusätzliche Parameter

Adressdeskriptoren 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 der 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 Geocoding 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 die 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" ]
        }
     ]
  }
}

Jedes address_descriptor-Objekt enthält zwei Arrays: landmarks und areas. Das landmarks-Array enthält bis zu fünf Ergebnisse, die nach Relevanz sortiert sind. Dabei werden die Nähe zur angeforderten Koordinate, die Häufigkeit des Wahrzeichens und seine Sichtbarkeit berücksichtigt. Jedes Ergebnis für Markierungen enthält die folgenden Werte:

• place_id ist die Orts-ID des Ergebnisses für Sehenswürdigkeiten. Weitere Informationen finden Sie unter Orts-IDs.
• display_name ist der Anzeigename des Wahrzeichens und enthält language_code und text.
• straight_line_distance_meters ist die Entfernung zwischen den beiden Punkten in Metern.
• travel_distance_meters ist die Entfernung in Metern, die über das Straßennetz zurückgelegt wurde (ohne Berücksichtigung von Straßeneinschränkungen) zwischen der Eingabekoordinate und dem Ergebnis für Markierungen.
• spatial_relationship ist das geschätzte Verhältnis zwischen der Eingabekoordinate und dem Ergebnis für Markierungen:
• "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 eingegebene Koordinate direkt an das Wahrzeichen oder den Zugang zum Wahrzeichen angrenzt.
• "ACROSS_THE_ROAD", wenn sich die eingegebene Koordinate direkt gegenüber dem Wahrzeichen auf der anderen Seite der Route befindet.
• "DOWN_THE_ROAD", wenn sich die Eingabekoordinate auf derselben Route wie der Markierungspunkt befindet, aber nicht "BESIDES" oder "ACROSS_THE_ROAD".
• "AROUND_THE_CORNER", wenn sich die Eingabekoordinate auf einer senkrechten Route wie das Wahrzeichen befindet (auf eine einzige Abbiegung beschränkt).
• "BEHIND", wenn sich die Eingabekoordinate zwar in der Nähe des Wahrzeichens, aber weit vom Zugangspunkt entfernt befindet.
• types sind die Ortstypen des Wahrzeichens.

Das areas-Objekt enthält bis zu drei Antworten und beschränkt sich auf Orte, die kleine Regionen darstellen, z. B. Viertel, Ortsteile und große Komplexe. Gebiete, die die angeforderte Koordinate enthalten, werden zuerst aufgeführt und von klein nach groß sortiert. Jedes areas-Ergebnis enthält die folgenden Werte:

• place_id ist die Orts-ID des Ergebnisses für Gebiete. Weitere Informationen finden Sie unter Orts-IDs.
• display_name ist der Anzeigename des Gebiets und enthält language_code und text.
• containment ist das geschätzte Begrenzungsverhältnis zwischen der Eingabekoordinate und dem Ergebnis für die Bereiche:
• "NEAR" ist die Standardbeziehung, wenn keine der folgenden Optionen zutrifft.
• "WITHIN", wenn die Eingabekoordinate sich nahe dem Zentrum des Gebiets befindet.
• "OUTSKIRTS", wenn sich die Eingabekoordinate nahe am Rand des Gebiets befindet.

Abdeckung

Adressdeskriptoren sind in allen Regionen verfügbar. Weitere Informationen finden Sie unter Abdeckung.

Feedback

Dies ist eine Vorabversion und wir würden uns über Feedback freuen. Bitte senden Sie uns eine E-Mail an address-descriptors-feedback@google.com.