Anfrage und Antwort für Adressdeskriptoren

Entwickler im Europäischen Wirtschaftsraum (EWR)

Adressbeschreibungen enthalten zusätzliche Informationen, die dazu beitragen, einen Standort anhand von Orientierungspunkten und Gebieten zu beschreiben. Demo für Adressdeskriptoren

Zusätzliche Parameter

Adressdeskriptoren können mit dem Parameter extra_computations aktiviert werden. Fügen Sie extra_computations=ADDRESS_DESCRIPTORS in eine Geocoding-Anfrage, Reverse-Geocoding-Anfrage oder Places-Geocoding-Anfrage ein, um Adressdeskriptoren in Ihrer Antwort zu erhalten.

Beispiel für Geocoding

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 Geokodierung an verschiedenen 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ängengradwert 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 address_descriptor sieht wie folgt 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 Array landmarks enthält bis zu fünf Ergebnisse, die nach Relevanz sortiert sind. Dabei werden die Nähe zur angeforderten Koordinate, die Häufigkeit des Orientierungspunkts und seine Sichtbarkeit berücksichtigt. Jedes Landmark-Ergebnis 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 Orientierungspunkts und enthält language_code und text.
  • straight_line_distance_meters ist die Entfernung in Metern zwischen der Eingabekoordinate und dem Ergebnis für Sehenswürdigkeiten.
  • travel_distance_meters ist die Entfernung in Metern, die über das Straßennetz (ohne Berücksichtigung von Straßenbeschränkungen) zwischen der Eingabekoordinate und dem Ergebnis für Orientierungspunkte zurückgelegt wird.
  • spatial_relationship ist die geschätzte Beziehung zwischen der Eingabekoordinate und dem Ergebnis der Landmarken:
    • "NEAR" ist die Standardbeziehung, wenn keine der folgenden Bedingungen zutrifft.
    • "WITHIN", wenn die eingegebene Koordinate innerhalb der Grenzen der Struktur liegt, die mit dem Orientierungspunkt verknüpft ist.
    • "BESIDE", wenn die Eingabekoordinate direkt neben dem Orientierungspunkt oder dem Zugangspunkt des Orientierungspunkts liegt.
    • "ACROSS_THE_ROAD", wenn die Eingabekoordinate auf der anderen Seite der Route direkt gegenüber dem Orientierungspunkt liegt.
    • "DOWN_THE_ROAD", wenn die Eingabekoordinate auf derselben Route wie das Landmark liegt, aber nicht "BESIDES" oder "ACROSS_THE_ROAD".
    • "AROUND_THE_CORNER", wenn die Eingabekoordinate auf einer senkrechten Route zur Sehenswürdigkeit liegt (auf eine einzelne Abbiegung beschränkt).
    • "BEHIND", wenn die Eingabekoordinate räumlich nah am Orientierungspunkt, aber weit von seinem Zugangspunkt entfernt ist.
  • types sind die Ortstypen der Sehenswürdigkeit.

Das areas-Objekt enthält bis zu drei Antworten und beschränkt sich auf Orte, die kleine Regionen wie Stadtteile, untergeordnete Orte und große Komplexe repräsentieren. Gebiete, die die angeforderte Koordinate enthalten, werden zuerst aufgelistet und von klein nach groß sortiert. Jedes areas-Ergebnis enthält die folgenden Werte:

  • place_id ist die Orts-ID des Bereichsergebnisses. Weitere Informationen finden Sie unter Orts-IDs.
  • display_name ist der Anzeigename des Bereichs und enthält language_code und text.
  • containment ist die geschätzte Beziehung zwischen der Eingabekoordinate und dem Ergebnis für die Bereiche:
    • "NEAR" ist die Standardbeziehung, wenn keine der folgenden Bedingungen zutrifft.
    • "WITHIN", wenn die eingegebene Koordinate in der Nähe des Mittelpunkts des Gebiets liegt.
    • "OUTSKIRTS", wenn die eingegebene Koordinate sich in der Nähe des Rands des Bereichs befindet.

Abdeckung

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

Feedback

Diese Funktion ist in allen Regionen verfügbar und in Indien allgemein verfügbar. In allen anderen Regionen befindet sie sich in der experimentellen Vorab-GA-Phase. Wir freuen uns über Feedback. Senden Sie uns eine E‑Mail an address-descriptors-feedback@google.com.