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 wird. 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 Anfrage 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 die Orts-Geocodierung

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- und 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:

{
  "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 zwischen der Eingabekoordinate und dem Ergebnis für Sehenswürdigkeiten in Metern.
  • 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 Sehenswürdigkeiten zurückgelegt wurde.
  • 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" ist.
    • "AROUND_THE_CORNER", wenn die Eingabekoordinate auf einer senkrechten Route zur Sehenswürdigkeit liegt (beschränkt auf eine einzelne Abbiegung).
    • "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 aufgeführt 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 Gebiete:
    • "NEAR" ist die Standardbeziehung, wenn keine der folgenden Bedingungen zutrifft.
    • "WITHIN", wenn die eingegebene Koordinate in der Nähe des Mittelpunkts des Bereichs liegt.
    • "OUTSKIRTS", wenn sich die eingegebene Koordinate 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. In Indien ist sie 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.