Anfrage und Antwort für Adressdeskriptoren

Entwickler im Europäischen Wirtschaftsraum (EWR)

Adressdeskriptoren enthalten zusätzliche Informationen, mit denen ein Ort anhand von Sehenswürdigkeiten und Gebieten beschrieben werden kann. In der Demo zu Adressdeskriptoren können Sie die Funktion ausprobieren.

Zusätzliche Parameter

Adressdeskriptoren können mit dem extra_computations Parameter aktiviert werden. Fügen Sie einer Geocoding-Anfrage , einer Anfrage zur umgekehrten Geocodierung oder einer Geocoding-Anfrage für Orte extra_computations=ADDRESS_DESCRIPTORS hinzu, um Adressdeskriptoren in der 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 Geocoding für Orte

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 Wert für den Breiten- und Längengrad eines Ortes 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 einen 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 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 der Sehenswürdigkeit und ihre Sichtbarkeit berücksichtigt. Jedes Ergebnis für eine Sehenswürdigkeit enthält die folgenden Werte:

  • place_id ist die Orts-ID des Ergebnisses für die Sehenswürdigkeit. Weitere Informationen finden Sie unter Orts-IDs Übersicht.
  • display_name ist der Anzeigename der Sehenswürdigkeit und enthält language_code und text.
  • straight_line_distance_meters ist die Entfernung in Metern zwischen der Eingabekoordinate und dem Ergebnis für die Sehenswürdigkeit.
  • travel_distance_meters ist die Entfernung in Metern zwischen der Eingabekoordinate und dem Ergebnis für die Sehenswürdigkeit, die über das Straßennetz zurückgelegt wird (ohne Berücksichtigung von Straßenbeschränkungen).
  • spatial_relationship ist die geschätzte Beziehung zwischen der Eingabekoordinate und dem Ergebnis für die Sehenswürdigkeit:
    • "NEAR" ist die Standardbeziehung, wenn keine der folgenden Beziehungen zutrifft.
    • "WITHIN": Die Eingabekoordinate liegt innerhalb der Grenzen der Struktur, die mit der Sehenswürdigkeit verknüpft ist.
    • "BESIDE": Die Eingabekoordinate liegt direkt neben der Sehenswürdigkeit oder dem Zugangspunkt der Sehenswürdigkeit.
    • "ACROSS_THE_ROAD": Die Eingabekoordinate liegt direkt gegenüber der Sehenswürdigkeit auf der anderen Straßenseite.
    • "DOWN_THE_ROAD": Die Eingabekoordinate liegt auf derselben Straße wie die Sehenswürdigkeit, aber nicht "BESIDES" oder "ACROSS_THE_ROAD".
    • "AROUND_THE_CORNER": Die Eingabekoordinate liegt auf einer senkrechten Straße zur Sehenswürdigkeit (beschränkt auf eine einzige Abzweigung).
    • "BEHIND": Die Eingabekoordinate liegt räumlich in der Nähe der Sehenswürdigkeit, aber weit entfernt von ihrem Zugangspunkt.
  • types sind die Ortstypen der Sehenswürdigkeit.

Das Objekt areas enthält bis zu drei Antworten und ist auf Orte beschränkt, die kleine Regionen wie Stadtteile, Unterorte und große Komplexe darstellen. Gebiete, die die angeforderte Koordinate enthalten, werden zuerst aufgeführt und von der kleinsten zur größten sortiert. Jedes areas-Ergebnis enthält die folgenden Werte:

  • place_id ist die Orts-ID des Ergebnisses für das Gebiet. Weitere Informationen finden Sie unter Orts-IDs Übersicht.
  • display_name ist der Anzeigename des Gebiets und enthält language_code und text.
  • containment ist die geschätzte Beziehung zwischen der Eingabekoordinate und dem Ergebnis für das Gebiet:
    • "NEAR" ist die Standardbeziehung, wenn keine der folgenden Beziehungen zutrifft.
    • "WITHIN": Die Eingabekoordinate liegt in der Nähe des Zentrums des Gebiets.
    • "OUTSKIRTS": Die Eingabekoordinate liegt in der Nähe des Randes des Gebiets.

Abdeckung

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

Feedback

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