Anfrage und Antwort für Adressdeskriptoren für umgekehrtes Geocoding

Adressdeskriptoren geben zusätzliche Informationen an die standardmäßige umgekehrte Geocodierungsantwort zurück, mit der die Breiten- und Längengradkoordinaten mithilfe von Orientierungspunkten und Gebieten beschrieben werden können. Sehen Sie sich die Demo zu Adressdeskriptoren an, um die API kennenzulernen.

Anfragen für umgekehrtes Geocoding – zusätzliche Parameter

Optionale Parameter

Die folgenden optionalen Parameter können in eine Anfrage zum umgekehrten Geocoding aufgenommen werden:

• enable_address_descriptor: Ein boolescher Parameter, der in die umgekehrte Geocoding-Anfrage eingebunden wird, um den Adressdeskriptor der standardmäßigen Antwort für die umgekehrte Geocodierung hinzuzufügen.

Beispiel für die umgekehrte Geocodierung

Die folgende Abfrage enthält den Breiten- und Längengradwert für einen Ort in Delhi:

https://maps.googleapis.com/maps/api/geocode/json?latlng=28.640964,77.235875&key=YOUR_API_KEY&enable_address_descriptor=true

Hinweis: Zwischen den Breiten- und Längengradwerten darf kein Leerzeichen stehen, wenn sie mit dem Parameter latlng übergeben werden.

Antwort

Die obige Abfrage gibt eine zusätzliche address_descriptor wie folgt zurück:

{
  "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" ]
        }
     ]
  },
 ... Results (reverse geocoding response) ...

Jedes address_descriptor-Objekt enthält zwei Arrays: landmarks und areas. Das Array landmarks enthält bis zu fünf Ergebnisse, die nach Relevanz geordnet sind. Dabei werden die Nähe zur angeforderten Koordinate, die Verbreitung der Sehenswürdigkeit und ihre Sichtbarkeit berücksichtigt. Jedes Ergebnis für Sehenswürdigkeiten 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 der Abstand von Punkt zu Punkt in Metern zwischen den Eingabekoordinaten und dem Ergebnis der Orientierungspunkte.
• travel_distance_meters ist die Entfernung in Metern, die im Straßennetz (ohne Straßeneinschränkungen) zwischen den Eingabekoordinaten und den Ergebnissen der Orientierungspunkte zurückgelegt wird.
• spatial_relationship ist die geschätzte Beziehung zwischen den Eingabekoordinaten und dem Ergebnis der Sehenswürdigkeiten:
• "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 Eingabekoordinaten direkt neben dem Zugangspunkt der Sehenswürdigkeit liegen.
• "ACROSS_THE_ROAD", wenn die Eingabekoordinate direkt gegenüber der Sehenswürdigkeit auf der anderen Seite der Route liegt.
• "DOWN_THE_ROAD", wenn die Eingabekoordinaten sich auf derselben Route wie die Sehenswürdigkeit befinden, aber nicht auf "BESIDES" oder "ACROSS_THE_ROAD".
• "AROUND_THE_CORNER", wenn die Eingabekoordinaten sich auf einer senkrechten Route als Orientierungspunkt befinden (auf eine einzelne Abzweigung beschränkt).
• "BEHIND", wenn die Eingabekoordinate räumlich in der Nähe der Sehenswürdigkeit, aber weit vom 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 darstellen, z. B. Viertel, Unterortsteile und große Anlagen. Bereiche mit den angeforderten Koordinaten werden zuerst aufgeführt und vom kleinsten zum größten geordnet. Jedes areas-Ergebnis enthält die folgenden Werte:

• place_id ist die Orts-ID des Gebietsergebnisses. 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 Eindämmungsbeziehung zwischen den Eingabekoordinaten und den resultierenden Flächen:
• "NEAR" ist die Standardbeziehung, wenn keiner der folgenden Punkte zutrifft.
• "WITHIN", wenn die Eingabekoordinaten nahe am Mittelpunkt des Bereichs liegen.
• "OUTSKIRTS", wenn die Eingabekoordinate nah am Rand des Bereichs liegt.

Abdeckung

Diese Funktion ist nur in ausgewählten Ländern verfügbar.

Feedback

Dies ist eine experimentelle Funktion. Wir würden uns über Feedback freuen. Bitte senden Sie uns eine E-Mail an [e-mail].