Anfrage und Antwort für Adressdeskriptoren

Entwickler im Europäischen Wirtschaftsraum (EWR)

Adressdeskriptoren enthalten zusätzliche Informationen, die einen Ort mithilfe von Sehenswürdigkeiten und Gebieten beschreiben. In der Demo zu Adressdeskriptoren können Sie die Funktion ausprobieren.

Zusätzliche Parameter

Adressbeschreibungen können mit dem Parameter extra_computations aktiviert werden. Wenn Sie extra_computations=ADDRESS_DESCRIPTORS in eine Geocoding-Anfrage, eine Anfrage zur umgekehrten Geocodierung oder eine Geocoding-Anfrage für Orte einfügen, erhalten Sie in der Antwort Adressdeskriptoren.

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 Places Geocoding

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 die umgekehrte Geocodierung

Die folgende Abfrage enthält die Werte für 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

Hier 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 Verbreitung der Sehenswürdigkeit und ihre Sichtbarkeit berücksichtigt. Jedes Sehenswürdigkeitsergebnis 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 der Sehenswürdigkeit und enthält language_code und text.
  • straight_line_distance_meters ist die Punkt-zu-Punkt-Entfernung in Metern zwischen der Eingabekoordinate und dem Ergebnis für die Sehenswürdigkeit.
  • travel_distance_meters ist die Entfernung in Metern, die über das Straßennetz (ohne Berücksichtigung von Straßeneinschränkungen) zwischen der Eingabekoordinate und dem Sehenswürdigkeiten-Ergebnis zurückgelegt wird.
  • spatial_relationship ist die geschätzte Beziehung zwischen der Eingabekoordinate und dem Landmark-Ergebnis:
    • "NEAR" ist die Standardbeziehung, wenn keine der folgenden Bedingungen zutrifft.
    • "WITHIN", wenn die Eingabekoordinate innerhalb der Grenzen der Struktur liegt, die mit der Sehenswürdigkeit verknüpft ist.
    • "BESIDE", wenn die Eingabekoordinate direkt an die Sehenswürdigkeit oder den Zugangspunkt der Sehenswürdigkeit angrenzt.
    • "ACROSS_THE_ROAD", wenn sich die Eingabekoordinate direkt gegenüber der Sehenswürdigkeit auf der anderen Seite der Route befindet.
    • "DOWN_THE_ROAD", wenn die Eingabekoordinate auf derselben Route wie die Sehenswürdigkeit liegt, aber nicht "BESIDES" oder "ACROSS_THE_ROAD".
    • "AROUND_THE_CORNER", wenn die Eingabekoordinate auf einer Route liegt, die senkrecht zur Sehenswürdigkeit verläuft (beschränkt auf eine einzelne Abbiegung).
    • "BEHIND", wenn die Eingabekoordinate räumlich nahe am POI, aber weit von seinem Zugangspunkt entfernt ist.
  • 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 Nachbarschaften, untergeordnete Orte und große Komplexe darstellen. Gebiete, die die angeforderte Koordinate enthalten, werden zuerst aufgeführt und sind von der kleinsten zur größten Fläche sortiert. Jedes areas-Ergebnis enthält die folgenden Werte:

  • place_id ist die Orts-ID des Gebietergebnisses. 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 Eingabekoordinate nahe der Mitte des Bereichs liegt.
    • "OUTSKIRTS", wenn die Eingabekoordinate nahe am Rand des Bereichs liegt.

Abdeckung

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

Feedback

Diese Funktion ist in allen Regionen verfügbar. Sie ist in Indien allgemein verfügbar und befindet sich in allen anderen Regionen in der experimentellen pre-GA-Phase. Wir freuen uns über Feedback. Bitte melden Sie den Fehler im Issue Tracker.