Nach Zielen suchen

Entwickler im Europäischen Wirtschaftsraum (EWR)

A Destination bezieht sich auf einen bestimmten Ort oder Platz, den ein Nutzer erreichen oder zu dem er navigieren möchte. Ein Destination-Objekt enthält auch eine Sammlung von Informationen zum Ort oder Platz, z. B. Navigationspunkte, Sehenswürdigkeiten, Eingänge und Gebäudeumrisse.

Die SearchDestinations Methode der Geocoding API ermöglicht es Ihnen, detaillierte Informationen zu verschiedenen Zielen basierend auf unterschiedlichen Eingabekriterien abzurufen, wie z. B. einer Adresse, einer Orts-ID oder Koordinaten für Breiten- und Längengrad.

Anfrage zum Suchen nach Zielen

Eine Anfrage zum Suchen nach Zielen ist eine HTTP-POST-Anfrage an eine URL im folgenden Format:

https://geocode.googleapis.com/v4/geocode/destinations

Übergeben Sie alle Parameter im JSON-Anfragetext oder in Headern als Teil der POST-Anfrage. Beispiel:

curl -X POST -d '{
  "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

Sie können den Ort, an dem nach einem Ziel gesucht werden soll, auf drei Arten angeben:

  • Adresse
  • Orts-ID
  • Koordinaten für Breiten- und Längengrad

Nach einem Ziel anhand der Adresse suchen

Sie können die Adresse als unstrukturierten String angeben. Bei der Adressgeocodierung werden keine Koordinaten für Breiten- und Längengrad oder andere unstrukturierte Strings aufgelöst, die keine Adresse darstellen. Anfragen mit solchen Strings werden nicht unterstützt und können zu Fehlerantworten oder nicht spezifiziertem Verhalten führen. Beispiele für nicht unterstützte Anfragen:

Abfragetyp Beispiel
Koordinaten für Breiten- und Längengrad Verwenden Sie stattdessen eine Standortabfrage. "37.422131,-122.084801"
Zu viele Konzepte oder Einschränkungen, z. B. die Namen mehrerer Orte, Straßen oder Städte in einer einzigen Abfrage "Market Street San Francisco San Jose Airport"
Postadressenelemente, die nicht in Google Maps dargestellt werden "C/O John Smith 123 Main Street"
"P.O. Box 13 San Francisco"
Namen von Unternehmen, Ketten oder Kategorien in Kombination mit Orten, an denen diese Entitäten nicht verfügbar sind "Tesco near Dallas, Texas"
Mehrdeutige Abfragen mit mehreren Interpretationen "Charger drop-off"
Historische Namen, die nicht mehr verwendet werden "Middlesex United Kingdom"
Nicht geografische Elemente oder Absichten "How many boats are in Ventura Harbor?"
Inoffizielle oder Vanity-Namen "The Jenga"
"The Helter Skelter"
Große politische Einheiten (Städte, Bundesländer, Länder) "New York City"
"California"
"USA"
Routen ohne bestimmte Adressen "1st Ave., NYC, NY"
"I-95" 
curl -X POST -d '{
  "addressQuery": {
    "addressQuery": "601 S Bernardo Ave, Sunnyvale, CA 94087, USA"
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

oder als postalAddress:

curl -X POST -d '{
  "addressQuery": {
    "address": {
      "addressLines": ["601 S Bernardo Ave"],
      "locality": "Sunnyvale",
      "postalCode": "94087",
      "administrativeArea": "CA",
      "regionCode": "US"
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

Das Format postalAddress wird in der Regel verwendet, wenn Adresskomponenten verarbeitet werden, die in einem HTML-Formular erfasst wurden.

Nach einem Ziel anhand der Orts-ID suchen

Sie können ein Ziel abrufen, indem Sie eine Orts ID angeben:

curl -X POST -d '{
  "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

Unterstützte Orts-IDs

Die Methode „Search Destinations“ funktioniert am besten mit Orts-IDs, die bestimmte, navigierbare Ziele darstellen. Orts-IDs für Typen wie establishment, point_of_interest, premise, street_address, und subpremise werden im Allgemeinen unterstützt. Orts-IDs, die keine diskreten Orte darstellen, z. B. solche, die aus Adressbereichen abgeleitet wurden (z. B. „10–20 Main St“), Abschnitte einer Route ohne bestimmte Nummer oder Plus Codes, werden nicht unterstützt. Orts-IDs für Ergebnisse, die zu groß sind (z. B. „Pazifischer Ozean“), werden ebenfalls nicht unterstützt.

Automatische Vervollständigung (neu) mit „Search Destinations“ verwenden

Verwenden Sie die automatische Vervollständigung (neu), um Orts IDs für die Verwendung mit „Search Destinations“ zu finden. Wenn Sie die automatische Vervollständigung (neu) verwenden, sollten Sie die Ergebnisse mit dem includedPrimaryTypes Parameter nach Typ filtern. Orts-IDs, die von der automatischen Vervollständigung (neu) mit dem folgenden empfohlenen Filter zurückgegeben werden, werden von „Search Destinations“ unterstützt:

"includedPrimaryTypes": [ "establishment", "point_of_interest", "premise", "street_address", "subpremise" ]

Außerdem sollten Sie das include_pure_service_area_businesses Flag true in Ihrer Anfrage für die automatische Vervollständigung (neu) nicht setzen.

Nach einem Ziel anhand des Standorts suchen

Sie können nach einem Ziel suchen, indem Sie Koordinaten für Breiten- und Längengrad angeben:

curl -X POST -d '{
  "locationQuery": {
    "location": {
      "latitude": 37.37348780,
      "longitude": -122.05678064
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

Anfrage mit OAuth stellen

Die Geocoding API v4 unterstützt OAuth 2.0 für die Authentifizierung. Wenn Sie OAuth mit der Geocoding API verwenden möchten, muss dem OAuth-Token der richtige Bereich zugewiesen sein. Die Geocoding API unterstützt die folgenden Bereiche für die Verwendung mit der Methode „Destinations“:

  • https://www.googleapis.com/auth/maps-platform.geocode : Für alle Methoden der Geocoding API verwenden.

Außerdem können Sie den allgemeinen Bereich https://www.googleapis.com/auth/cloud-platform für alle Methoden der Geocoding API verwenden. Dieser Bereich ist während der Entwicklung nützlich, aber nicht in der Produktion, da er ein allgemeiner Bereich ist, der Zugriff auf alle Methoden ermöglicht.

Weitere Informationen und Beispiele finden Sie unter OAuth verwenden.

Antwort auf die Anfrage zum Suchen nach Zielen

Die Antwort auf die Anfrage zum Suchen nach Zielen bietet umfassenden, hyperlokalen Kontext zum Standort.

Die PlaceView-Objekte in der Antwort auf die Anfrage zum Suchen nach Zielen (z. B. primary, Elemente in containingPlaces und landmarks) verwenden Felder, um den Ortstyp anzugeben:

  • types: Ein Array von Strings, das den Typ oder die Typen des Ortes angibt.
  • primaryType: Ein String, der den primären Typ des Ortes angibt.

Die möglichen Stringwerte für types und primaryType stammen aus Tabelle A und Tabelle B auf der Seite Ortstypen (neu).

In diesem Abschnitt werden die wichtigsten Antwortfelder beschrieben. Vollständige Details zu allen Antwort feldern finden Sie in der API Referenz.

primary

Der Hauptort, der durch die Abfrage in der Anfrage identifiziert wurde.

addressComponents

Ein Array, das die einzelnen Komponenten für diese Adresse enthält.

Jede Adresskomponente enthält normalerweise die folgenden Felder:

  • types[] ist ein Array, das den Typ der Adresskomponente angibt. Sehen Sie sich die Liste der unterstützten Typen an.
  • longText ist die Volltextbeschreibung oder der Name der Adresskomponente, wie vom Geocoder zurückgegeben.
  • shortText ist ein abgekürzter Textname für die Adresskomponente, falls vorhanden. Beispielsweise könnte eine Adresskomponente für den US-Bundesstaat Alaska den longText „Alaska“ und den shortText „AK“ haben, entsprechend der postalischen Abkürzung.
  • languageCode ist die Sprache, die zum Formatieren dieser Komponente verwendet wird, in CLDR-Notation.

containingPlaces

Größere Entitäten, zu denen das primäre Ziel gehört (z. B. ein Einkaufszentrum mit einem Geschäft).

subDestinations

Spezifischere Orte innerhalb des primären Ziels (z. B. Apartments in einem Gebäude).

entrances

Die Objekte im Array entrances[] haben die folgenden Felder:

  • location

    Ein einzelnes Koordinatenpaar für Breiten- und Längengrad, das den Standort eines Ein- und Ausgangspunkts zu einem Ort definiert.

  • entrance_tags[]

    Ein Array von Eingangstags, die Merkmale des Eingangs beschreiben. Der folgende Wert wird unterstützt:

    • "PREFERRED"

    Gibt an, dass dieser Eingang wahrscheinlich physischen Zugang zum zurückgegebenen Ort bietet. Ein Ort kann mehrere bevorzugte Eingänge haben. Wenn ein Eingang dieses Tag nicht hat, befindet er sich zwar physisch im selben Gebäude, bietet aber nicht unbedingt Zugang zum Ort.

    Wenn der zurückgegebene Ort beispielsweise ein Restaurant in einem Einkaufszentrum ist, sind die "PREFERRED" Eingänge die Eingänge, die direkt ins Restaurant führen. Die anderen zurückgegebenen Eingänge sind andere Eingänge für das Gebäude, z. B. Eingänge zu anderen Restaurants im Einkaufszentrum.

    Wenn der zurückgegebene Ort ein Gebäude selbst ist, sind die "PREFERRED" Eingänge die Eingänge, die zum "Hauptteil" des Gebäudes führen. In einem Einkaufszentrum sind die Eingänge mit dem Tag "PREFERRED" beispielsweise die Eingänge, die Zugang zum Hauptfoyer bieten. Wenn ein Eingang nur Zugang zu einem Geschäft an der Seite des Gebäudes bietet, ist er kein Eingang mit dem Tag "PREFERRED".

  • streetViewThumbnail und streetViewAnnotation

    Parameter für die Street View Static API, mit denen Sie relevante Bilder für diese Orte anzeigen können. Weitere Informationen zu diesen Feldern.

structureType

Der Typ der Struktur, die dieser Ort darstellt.

  • POINT

    Ein Punktstandort.

  • SECTION

    Ein Unterabschnitt eines Gebäudes.

  • BUILDING

    Ein Gebäude.

  • GROUNDS

    Ein großes Gebiet, das in der Regel mehrere Gebäude enthält, z. B. ein Universitätscampus, ein Apartmentkomplex oder ein Einkaufszentrum.

Das Feld navigationPoints in der Geocoding-Antwort enthält eine Liste von Punkten, die für die Navigation zum Ort nützlich sind. Sie sollten entweder als Start- oder Endpunkte verwendet werden, wenn Sie in einem Straßennetz von oder zu dem Ort navigieren.

Jeder Navigationspunkt enthält die folgenden Werte:

  • navigationPointToken ist ein Token, das die Kontextinformationen im Feld navigationPoints enthält. Sie können dieses Token an Routing- und Navigations-APIs senden, um das Routing und die Navigation in Ihrer App zu verbessern. Weitere Informationen finden Sie unter Routen mit Navigationspunkt Tokens.
  • location enthält die Koordinaten für Breiten- und Längengrad des Navigationspunkts. Dieser Standort befindet sich immer in unmittelbarer Nähe des Straßennetzes und ist ein idealer Halte- oder Startpunkt für die Navigation zu und von einem Ort. Der Punkt ist absichtlich leicht von der Mittellinie der Straße versetzt, um die Straßenseite, auf der sich der Ort befindet, deutlich zu kennzeichnen.
  • travelModes ist eine Liste der Mobilitätsformen, mit denen der Navigationspunkt erreichbar ist:
    • "DRIVE" ist die Mobilitätsform, die der Wegbeschreibung für Autofahrer entspricht.
    • "WALK" ist die Mobilitätsform, die der Fußgängerroute entspricht.
  • usages ist eine Liste der vom Navigationspunkt unterstützten Verwendungszwecke. Verwendungszwecke können sein:
    • "DROPOFF"
    • "PICKUP"
    • "PARKING"

Verwenden Sie für Abholungen und Absetzungen den Navigationspunkt, bei dem die Mobilitätsform DRIVE und der Verwendungszweck PICKUP oder DROPOFF ist. Wenn keine Abhol- oder Absetzpunkte verfügbar sind, verwenden Sie den obersten Navigationspunkt für Autofahrer.

  • altitude_meters enthält die Höhe des Navigationspunkts in Metern relativ zum WGS-84-Ellipsoid. In Fällen, in denen Straßenabschnitte vertikal übereinander liegen, können Sie mit dem Feld altitude_meters den besten Straßenabschnitt für die Navigation Ihres Systems auswählen.

landmarks

Bemerkenswerte Orte in der Nähe, die Nutzern helfen, die Umgebung des Ziels zu verstehen.

arrivalSummary

KI-gestützte Statistiken zur Unterstützung bei der Ankunft. Weitere Informationen zu KI-gestützten Zusammenfassungen.

parkingOptions

Detaillierte Parkplatzinformationen.

Antwortformat

„SearchDestinations“ gibt eine SearchDestinationsResponse im folgenden JSON-Format zurück:

{
  "destinations": [
    {
      "primary": {
        "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w",
        "displayName": {
          "text": "Arby's",
          "languageCode": "en"
        },
        "primaryType": "fast_food_restaurant",
        "types": [
          "fast_food_restaurant",
          "sandwich_shop",
          "deli",
          "meal_takeaway",
          "food_delivery",
          "american_restaurant",
          "restaurant",
          "food_store",
          "store",
          "food",
          "point_of_interest",
          "establishment"
        ],
        "formattedAddress": "Arby's, 601 S Bernardo Ave, Sunnyvale, CA 94087, USA",
        "postalAddress": {
          "regionCode": "US",
          "languageCode": "en",
          "postalCode": "94087",
          "administrativeArea": "CA",
          "locality": "Sunnyvale",
          "addressLines": [
            "601 S Bernardo Ave"
          ]
        },
        "structureType": "BUILDING",
        "location": {
          "latitude": 37.3734545,
          "longitude": -122.05693269999998
        },
        "displayPolygon": {
          "type": "Polygon",
          "coordinates": [
            [
              [
                -122.056930138027,
                37.3735253692531
              ],
              [
                -122.056960139391,
                37.3735372663597
              ],
              [
                -122.056994129366,
                37.3734828786847
              ],
              [
                -122.056969677395,
                37.3734731161089
              ],
              [
                -122.057061762447,
                37.3733261309656
              ],
              [
                -122.056979388817,
                37.3732935577128
              ],
              [
                -122.056798860285,
                37.3735818838642
              ],
              [
                -122.056875858081,
                37.3736121235316
              ],
              [
                -122.056930138027,
                37.3735253692531
              ]
            ]
          ]
        }
      },
      "containingPlaces": [
        {
          "place": "places/ChIJYfdAFum2j4ARIcL2tjME3Sw",
          "displayName": {
            "text": "Cherry Chase Shopping Center",
            "languageCode": "en"
          },
          "primaryType": "shopping_mall",
          "types": [
            "shopping_mall",
            "point_of_interest",
            "establishment"
          ],
          "formattedAddress": "Cherry Chase Shopping Center, 663 S Bernardo Ave, Sunnyvale, CA 94087, USA",
          "postalAddress": {
            "regionCode": "US",
            "languageCode": "en",
            "postalCode": "94087-1020",
            "administrativeArea": "CA",
            "locality": "Sunnyvale",
            "addressLines": [
              "663 S Bernardo Ave"
            ]
          },
          "structureType": "GROUNDS",
          "location": {
            "latitude": 37.3731231,
            "longitude": -122.0578211
          },
          "displayPolygon": {
            "type": "Polygon",
            "coordinates": [
              [
                [
                  -122.057112227103,
                  37.3714618008523
                ],
                [
                  -122.057076849821,
                  37.3715743611411
                ],
                [
                  -122.056963607756,
                  37.3719081793948
                ],
                [
                  -122.056865279559,
                  37.3722026053835
                ],
                [
                  -122.056687872374,
                  37.3727258358476
                ],
                [
                  -122.056580005889,
                  37.3730511370747
                ],
                [
                  -122.056498845827,
                  37.3732994782583
                ],
                [
                  -122.056338259713,
                  37.3737878663325
                ],
                [
                  -122.056618678291,
                  37.373887693582
                ],
                [
                  -122.056912102521,
                  37.3740010327191
                ],
                [
                  -122.057532418159,
                  37.3742476426462
                ],
                [
                  -122.057673926626,
                  37.3742441740031
                ],
                [
                  -122.057735663106,
                  37.3742328516943
                ],
                [
                  -122.057766531332,
                  37.3742220604378
                ],
                [
                  -122.057797572967,
                  37.37420520725
                ],
                [
                  -122.057828267759,
                  37.3741852342085
                ],
                [
                  -122.058060299297,
                  37.3740060842535
                ],
                [
                  -122.058199726081,
                  37.3737861673422
                ],
                [
                  -122.05836707267,
                  37.373524542556
                ],
                [
                  -122.058569622393,
                  37.3732018598683
                ],
                [
                  -122.0587638478,
                  37.3728890198039
                ],
                [
                  -122.058934661823,
                  37.3726036257774
                ],
                [
                  -122.059164956851,
                  37.3722498383629
                ],
                [
                  -122.058997784906,
                  37.3721804442035
                ],
                [
                  -122.057936479838,
                  37.3717605636234
                ],
                [
                  -122.057495827092,
                  37.3715860151634
                ],
                [
                  -122.057112227103,
                  37.3714618008523
                ]
              ]
            ]
          }
        }
      ],
      "landmarks": [
        {
          "place": {
            "place": "places/ChIJXXTe7Oi2j4ARoMTA-D6Hjpg",
            "displayName": {
              "text": "Chase Bank",
              "languageCode": "en"
            },
            "primaryType": "bank",
            "types": [
              "bank",
              "atm",
              "finance",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Chase Bank, 1234 W El Camino Real, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "1234 W El Camino Real"
              ]
            },
            "structureType": "POINT",
            "location": {
              "latitude": 37.373579,
              "longitude": -122.05752700000001
            }
          },
          "relationalDescription": {
            "text": "Near Chase Bank",
            "languageCode": "en"
          },
          "tags": [
            "ARRIVAL",
            "ADDRESS"
          ],
          "straightLineDistanceMeters": 61.182193756103516,
          "travelDistanceMeters": 63.075645446777344
        },
        {
          "place": {
            "place": "places/ChIJteQ0Fum2j4ARGi3tqK4Zm14",
            "displayName": {
              "text": "Safeway",
              "languageCode": "en"
            },
            "primaryType": "grocery_store",
            "types": [
              "grocery_store",
              "butcher_shop",
              "florist",
              "deli",
              "supermarket",
              "bakery",
              "food_delivery",
              "market",
              "manufacturer",
              "food_store",
              "store",
              "food",
              "service",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Safeway, 639 S Bernardo Ave, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "639 S Bernardo Ave"
              ]
            },
            "structureType": "POINT",
            "location": {
              "latitude": 37.3727912,
              "longitude": -122.0581172
            }
          },
          "relationalDescription": {
            "text": "Around the corner from Safeway",
            "languageCode": "en"
          },
          "tags": [
            "ARRIVAL",
            "ADDRESS"
          ],
          "straightLineDistanceMeters": 158.65606689453125,
          "travelDistanceMeters": 131.1669921875
        },
        {
          "place": {
            "place": "places/ChIJu-PSYui2j4ARNiwOwBApGqk",
            "displayName": {
              "text": "Oil Changers",
              "languageCode": "en"
            },
            "types": [
              "car_repair",
              "service",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Oil Changers, 1240 W El Camino Real, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "1240 W El Camino Real"
              ]
            },
            "structureType": "POINT",
            "location": {
              "latitude": 37.3743054,
              "longitude": -122.0584272
            }
          },
          "relationalDescription": {
            "text": "Down the road from Oil Changers",
            "languageCode": "en"
          },
          "tags": [
            "ARRIVAL"
          ],
          "straightLineDistanceMeters": 140.52459716796875,
          "travelDistanceMeters": 143.24220275878906
        },
        {
          "place": {
            "place": "places/ChIJKRbl5oG3j4ARwuvPGUmtCj0",
            "displayName": {
              "text": "Apni Mandi Farmers Market Sunnyvale",
              "languageCode": "en"
            },
            "primaryType": "grocery_store",
            "types": [
              "grocery_store",
              "cake_shop",
              "supermarket",
              "asian_grocery_store",
              "indian_restaurant",
              "meal_takeaway",
              "bakery",
              "manufacturer",
              "wholesaler",
              "restaurant",
              "food_store",
              "store",
              "food",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Apni Mandi Farmers Market Sunnyvale, 1111 W El Camino Real, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087-1056",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "1111 W El Camino Real"
              ]
            },
            "structureType": "POINT",
            "location": {
              "latitude": 37.3737199,
              "longitude": -122.0522958
            }
          },
          "relationalDescription": {
            "text": "Near Apni Mandi Farmers Market Sunnyvale",
            "languageCode": "en"
          },
          "tags": [
            "ADDRESS"
          ],
          "straightLineDistanceMeters": 410.37435913085938,
          "travelDistanceMeters": 479.49893188476562
        },
        {
          "place": {
            "place": "places/ChIJ8enMlui2j4AR2xXK5EHDhBs",
            "displayName": {
              "text": "Starbird Chicken",
              "languageCode": "en"
            },
            "primaryType": "chicken_restaurant",
            "types": [
              "chicken_restaurant",
              "fast_food_restaurant",
              "restaurant",
              "food",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Starbird Chicken, 1241 W El Camino Real, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087-1028",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "1241 W El Camino Real"
              ]
            },
            "structureType": "BUILDING",
            "location": {
              "latitude": 37.3746764,
              "longitude": -122.05708860000001
            },
            "displayPolygon": {
              "coordinates": [
                [
                  [
                    -122.057003840785,
                    37.3747648209809
                  ],
                  [
                    -122.057136852459,
                    37.3747919153144
                  ],
                  [
                    -122.057205005705,
                    37.3745815131859
                  ],
                  [
                    -122.057071994114,
                    37.3745544186944
                  ],
                  [
                    -122.057003840785,
                    37.3747648209809
                  ]
                ]
              ],
              "type": "Polygon"
            }
          },
          "relationalDescription": {
            "text": "Near Starbird Chicken",
            "languageCode": "en"
          },
          "tags": [
            "ADDRESS"
          ],
          "straightLineDistanceMeters": 87.348007202148438,
          "travelDistanceMeters": 214.08084106445312
        }
      ],
      "entrances": [
        {
          "location": {
            "latitude": 37.3735328,
            "longitude": -122.05694879999999
          },
          "tags": [
            "PREFERRED"
          ],
          "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
        }
      ],
      "navigationPoints": [
        {
          "navigationPointToken": "ChIJeMt61tqvQkARWT2716SDXsASEgljyy_n6LaPgBH9LoGUMNHjbBoSCWPLL-foto-AEf0ugZQw0eNsIhIJhf5y6ei2j4ARz7yBW5KAPI4",
          "location": {
            "latitude": 37.3738659,
            "longitude": -122.05693620000001
          },
          "travelModes": [
            "DRIVE",
            "WALK"
          ],
          "usages": [
            "PARKING"
          ]
        }
      ]
    }
  ]
}

Erforderliche Parameter

  • Einer der folgenden drei Parameter muss in der API-Anfrage enthalten sein. Er gibt die Adresse, den Ort oder den Standort an, nach dem gesucht werden soll:
    • addressQuery : die Adresse, nach der gesucht werden soll.
    • place : die Orts-ID des Ortes, nach dem gesucht werden soll.
    • locationQuery : die Koordinaten für Breiten- und Längengrad des Standorts, nach dem gesucht werden soll.

  • FieldMask

    Geben Sie die Liste der Felder an, die in der Antwort zurückgegeben werden sollen, indem Sie eine Feldmaske für die Antwort erstellen. Übergeben Sie die Feldmaske für die Antwort an die Methode, indem Sie den URL-Parameter $fields oder fields, oder indem Sie den HTTP-Header X-Goog-FieldMask verwenden. Die folgende Anfrage gibt beispielsweise nur die Eingänge, Navigationspunkte und die Orts-ID des primären Ziels zurück.

      curl -X POST -d '{"place": "places/ChIJG3kh4hq6j4AR_XuFQnV0_t8"}' \
    -H "X-Goog-Api-Key: API_KEY" \
    -H "Content-Type: application/json" \
    -H "X-Goog-FieldMask: destinations.entrances,destinations.navigationPoints,destinations.primary.place" \
    https://geocode.googleapis.com/v4/geocode/destinations

    Es gibt keine Standardliste der zurückgegebenen Felder in der Antwort. Wenn Sie die Feldmaske weglassen, gibt die Methode einen Fehler zurück. Setzen Sie die Feldmaske auf * , um alle Felder zurückzugeben. Weitere Informationen finden Sie unter Felder für die Rückgabe auswählen.

Optionale Parameter

  • travelModes

    Gibt an, welche Arten von navigationPoints zurückgegeben werden sollen. Navigationspunkte für andere Mobilitätsformen werden herausgefiltert. Wenn travelModes nicht festgelegt ist, können Navigationspunkte aller Mobilitätsformen zurückgegeben werden.

  • languageCode

    Die Sprache, in der die Ergebnisse zurückgegeben werden sollen.

    • Sehen Sie sich die Liste der unterstützten Sprachen an. Die unterstützten Sprachen werden regelmäßig von Google aktualisiert sodass diese Liste möglicherweise nicht vollständig ist.
    • Wenn languageCode nicht angegeben ist, verwendet die API standardmäßig die lokale Sprache und Schrift des Standorts. Wenn Sie einen ungültigen Sprachcode angeben, gibt die API einen INVALID_ARGUMENT Fehler zurück.
    • Die API versucht, eine Adresse bereitzustellen, die sowohl für den Nutzer als auch für Einheimische lesbar ist. Zu diesem Zweck werden Straßen adressen in der lokalen Sprache zurückgegeben und bei Bedarf in eine für den Nutzer lesbare Schrift transliteriert, wobei die bevorzugte Sprache berücksichtigt wird. Alle anderen Adressen werden in der bevorzugten Sprache zurückgegeben. Adresskomponenten werden alle in derselben Sprache zurückgegeben, die anhand der ersten Komponente ausgewählt wird.
    • Wenn ein Name in der bevorzugten Sprache nicht verfügbar ist, verwendet die API die nächstbeste Übereinstimmung.
    • Die bevorzugte Sprache hat einen geringen Einfluss auf die Menge der Ergebnisse, die die API zurückgibt, und auf die Reihenfolge, in der sie zurückgegeben werden. Der Geocoder interpretiert Abkürzungen je nach Sprache unterschiedlich, z. B. die Abkürzungen für Straßentypen oder Synonyme, die in einer Sprache gültig sein können, in einer anderen jedoch nicht.

  • regionCode

    Der Regionscode als zweistelliger CLDR-Code. Es gibt keinen Standardwert. Die meisten CLDR-Codes entsprechen den ISO 3166-1-Codes.

    Bei der Geocodierung einer Adresse (Forward Geocoding) kann dieser Parameter die Ergebnisse des Dienstes für die angegebene Region beeinflussen, aber nicht vollständig einschränken. Bei der Geocodierung eines Standorts oder eines Ortes (umgekehrte Geocodierung oder Place Geocoding) kann dieser Parameter verwendet werden, um die Adresse zu formatieren. In allen Fällen kann dieser Parameter die Ergebnisse aufgrund geltenden Rechts beeinflussen.

  • placeFilter

    Ermöglicht es Ihnen, die Ergebnisse einer locationQuery Suche nach Ihren Anforderungen zu filtern, z. B. nur Ziele zurückzugeben, die Gebäude sind, oder nur Ziele mit eindeutigen Adressen.

    Nach struktureller Granularität filtern

    Mit dem Filter structureType können Sie die Art der Strukturen angeben, die von der Abfrage zurückgegeben werden:

    • Gebäude isolieren: Verwenden Sie "structureType": "BUILDING", um Gebäudeumrisse auf einer Karte anzuzeigen oder Details zu einer bestimmten Struktur abzurufen.
    • Komplexe verstehen: Verwenden Sie "structureType": "GROUNDS", um sicherzustellen, dass das primäre Ergebnis das gesamte Gelände ist. Das ist nützlich, wenn Sie nach größeren Gebieten wie Universitätscampussen oder Einkaufszentren suchen.
    • Auf Einheiten/Abschnitte konzentrieren: Verwenden Sie "structureType": "SECTION", um Abschnitte innerhalb eines Gebäudes zu identifizieren.

    Nützliche Adressen sicherstellen

    Nicht alle Orte haben eindeutige Adressen auf Straßenebene. Mit dem Filter addressability hilft Ihnen die Qualität der Adressen in Ihren Ergebnissen zu steuern:

    • Eindeutige primäre Adresse erforderlich: Wenn Sie sicherstellen möchten, dass das Hauptergebnis immer eine Adresse oder einen Namen auf Straßenebene hat, verwenden Sie "addressability": "PRIMARY". Das ist nützlich für Navigations- oder Anzeigezwecke, bei denen eine eindeutige Adresse entscheidend ist.
    • Adressen in Unterzielen zulassen: In Fällen, in denen der primäre Ort möglicherweise keine Adresse hat, aber Einheiten darin (z. B. Apartments in einem Gebäude), sorgt "addressability": "WEAK" dafür, dass mindestens der primäre Ort oder eines seiner Unterziele eine Adresse hat.
    • Beliebiges Ergebnis: Wenn die Adresspräsenz für Ihren Anwendungsfall nicht relevant ist, verwenden Sie "addressability": "ANY". Das ist sehr empfehlenswert, wenn Sie nur geometrische Attribute wie Gebäudeumrisse und Navigationspunkte benötigen, da es die Genauigkeit dieser Ergebnisse verbessert.
    Beispiel: Nach adressierbaren Gebäuden filtern 
    curl -X POST -d '{
  "locationQuery": {
    "location": {
      "latitude": 37.37348780,
      "longitude": -122.05678064
    },
    "placeFilter": {
      "structureType": "BUILDING",
      "addressability": "PRIMARY"
    }
  },
  "languageCode": "en"
}' \\
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \\
-H "X-Goog-FieldMask: place" \\
https://geocode.googleapis.com/v4/geocode/destinations