Anfrage und Antwort für Adressdeskriptoren

Adressbeschreibungen enthalten zusätzliche Informationen zur Beschreibung eines Standorts. mit Orientierungspunkten und Bereichen. In der Demo zu Adressbeschreibungen können Sie sich die Funktion ansehen.

Zusätzliche Parameter

Adressbeschreibungen können mit dem Parameter extra_computations aktiviert werden. extra_computations=ADDRESS_DESCRIPTORS in eine Geocoding-Anfrage einfügen , umgekehrte Geocoding-Anfrage oder eine Places-Geocoding-Anfrage um eine Beschreibung der Adresse in Ihrer Antwort zu erhalten.

Beispiel für die Geocodierung

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

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 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 der Sehenswürdigkeit und enthält language_code und text.
  • straight_line_distance_meters ist die Entfernung zwischen den Punkten in Metern zwischen der Eingabekoordinate und dem Ergebnis für Markierungen.
  • travel_distance_meters ist die Entfernung in Metern zwischen der Eingabekoordinate und dem Ergebnis der Sehenswürdigkeiten, die auf dem Straßennetz ohne Berücksichtigung von Straßeneinschränkungen zurückgelegt wurde.
  • spatial_relationship ist die geschätzte Beziehung zwischen der Eingabekoordinate und dem Ergebnis der Orientierungspunkte:
    • "NEAR" ist die Standardbeziehung, wenn keiner der folgenden Punkte zutrifft.
    • "WITHIN", wenn die Eingabekoordinate innerhalb der Grenzen des mit der Sehenswürdigkeit verknüpften Gebäudes liegt.
    • "BESIDE", wenn die Eingabekoordinate direkt neben dem Zugangspunkt der Sehenswürdigkeit oder Sehenswürdigkeit liegt.
    • "ACROSS_THE_ROAD", wenn sich die Eingabekoordinate direkt gegenüber dem Wahrzeichen 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 entlang einer senkrechten Route als Orientierungspunkt liegt (auf eine einzige Abbiegung beschränkt).
    • "BEHIND", wenn die Eingabekoordinate räumlich nahe an der Sehenswürdigkeit, aber weit von ihrem Zugangspunkt entfernt ist.
  • types sind die Ortstypen der Sehenswürdigkeit.

Das areas-Objekt enthält bis zu drei Antworten und ist auf Stellen beschränkt, kleine Regionen wie Stadtteile, Unterortsteile und große komplex. Gebiete, die die angeforderten Koordinaten enthalten, werden zuerst aufgeführt und vom Kleinsten zum größten sortiert. Jedes areas-Ergebnis enthält Folgendes: Werte:

  • place_id ist die Orts-ID der Ergebnisergebnisse. Sehen Sie sich die Orts-ID an. .
  • display_name ist der Anzeigename des Gebiets und enthält language_code und text.
  • containment ist die geschätzte Begrenzungsbeziehung zwischen der Eingabekoordinate und dem Ergebnis der Fläche:
    • "NEAR" ist die Standardbeziehung, wenn keiner der folgenden Punkte zutrifft.
    • "WITHIN", wenn sich die Eingabekoordinate in der Nähe des Zentrums 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 Funktion in der Vorabversion und wir würden uns über Ihr Feedback freuen. E-Mail senden senden Sie eine E-Mail an address-descriptors-feedback@google.com.