Nach Zielen suchen

Entwickler im Europäischen Wirtschaftsraum (EWR)

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

Mit der Methode SearchDestinations der Geocoding API können Sie detaillierte Informationen zu verschiedenen Zielen basierend auf unterschiedlichen Eingabekriterien wie einer Adresse, einer Orts-ID oder Breiten- und Längengradkoordinaten abrufen.

Anfrage für die Suche nach Zielen

Eine Anfrage zum Suchen von 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
  • Geografische Koordinaten (Breiten- und Längengrad)

Nach einem Zielort anhand der Adresse suchen

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

Abfragetyp Beispiel
Breiten- und Längengradkoordinaten. 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 einzelnen 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 Standorten, an denen diese nicht verfügbar sind „Tesco near Dallas, Texas“
Mehrdeutige Anfragen mit mehreren Interpretationen „Ladegerät abgeben“
Nicht mehr verwendete historische Namen "Middlesex United Kingdom"
Nicht-geospatial Elemente oder Absichten „Wie viele Boote sind im Ventura Harbor?“
Inoffizielle oder Vanity-Namen „The Jenga“
„The Helter Skelter“
Große politische Einheiten (Städte, Bundesländer, Länder) „New York City“
„Kalifornien“
„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 normalerweise verwendet, wenn Adresskomponenten verarbeitet werden, die in einem HTML-Formular erfasst wurden.

Nach einem Zielort 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 in der Regel unterstützt. Orts-IDs, die keine einzelnen Orte darstellen, z. B. solche, die aus Adressbereichen (z. B. „Hauptstraße 10–20“), Abschnitten einer Route ohne bestimmte Nummer oder Plus Codes abgeleitet werden, werden nicht unterstützt. Orts-IDs für Ergebnisse, die eine zu große Fläche abdecken (z. B. „Pazifischer Ozean“), werden ebenfalls nicht unterstützt.

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

Verwenden Sie Autocomplete (New), um Orts-IDs für die Verwendung mit Search Destinations zu finden. Wenn Sie Autocomplete (New) verwenden, sollten Sie die Ergebnisse mit dem Parameter includedPrimaryTypes nach Typ filtern. Orts-IDs, die von Autocomplete (New) 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 Flag include_pure_service_area_businesses in Ihrer Anfrage für die automatische Vervollständigung (New) nicht auf true setzen.

Nach einem Zielort anhand des Standorts suchen

Sie können nach einem Ziel suchen, indem Sie Breiten- und Längengrade 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

OAuth zum Stellen einer Anfrage verwenden

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 – Wird mit allen Geocoding API-Methoden verwendet.

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

Weitere Informationen und Beispiele finden Sie unter OAuth verwenden.

„Search Destinations“-Antwort

Die Antwort von Search Destinations enthält umfassenden, hyperlokalen Kontext zum Standort.

Die PlaceView-Objekte in der Antwort von „Search Destinations“ (z. B. primary, Elemente in containingPlaces und landmarks) verwenden Felder, um den Ortstyp anzugeben:

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

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

In diesem Abschnitt werden die wichtigsten Antwortfelder beschrieben. Ausführliche Informationen zu allen Antwortfeldern 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, in dem sich ein Geschäft befindet).

subDestinations

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

entrances

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

  • location

    Ein einzelnes Koordinatenpaar aus Breiten- und Längengrad, das die Position eines Ein- und Ausgangs eines Ortes definiert.

  • entrance_tags[]

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

    • "PREFERRED"

    Gibt an, dass dieser Eingang wahrscheinlich den physischen Zugang zum zurückgegebenen Ort ermöglicht. Ein Ort kann mehrere bevorzugte Eingänge haben. Wenn ein Eingang dieses Tag nicht hat, befindet er sich zwar am 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 des Gebäudes, z. B. Eingänge zu anderen Restaurants im Einkaufszentrum.

    Wenn der zurückgegebene Ort ein Gebäude ist, sind die "PREFERRED"-Eingänge diejenigen, die in den „Hauptteil“ des Gebäudes führen. In einem Einkaufszentrum sind die "PREFERRED"-Eingänge beispielsweise diejenigen, die den Zugang zum Hauptfoyer ermöglichen. Wenn ein Eingang nur den Zugang zu einem Geschäft an der Seite des Gebäudes ermöglicht, ist er kein "PREFERRED"-Eingang.

  • streetViewThumbnail und streetViewAnnotation

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

structureType

Der Strukturtyp, den dieser Ort darstellt.

  • POINT

    Ein Punktstandort.

  • SECTION

    Ein Teil eines Gebäudes.

  • BUILDING

    Ein Gebäude.

  • GROUNDS

    Ein großes Gebiet, das in der Regel mehrere Gebäude umfasst, z. B. ein Universitätsgelände, ein Wohnkomplex 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 insbesondere als Start- oder Endpunkte verwendet werden, wenn eine Route in einem Straßennetz von oder zu dem Ort berechnet wird.

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 Flussnavigation in Ihrer App zu verbessern. Weitere Informationen finden Sie unter Route mit Navigationspunkt-Tokens.
  • location enthält den Breiten- und Längengrad des Navigationspunkts. Diese Position befindet sich immer in unmittelbarer Nähe des Straßennetzes und ist ein idealer Start- oder Endpunkt für die Navigation zu einem Ort. Der Punkt ist absichtlich leicht von der Mittellinie der Straße versetzt, um die Straßenseite, auf der sich der Ort befindet, klar zu kennzeichnen.
  • travelModes ist eine Liste der Verkehrsmittel, mit denen der Navigationspunkt erreichbar ist:
    • "DRIVE" ist die Mobilitätsform, die der Wegbeschreibung entspricht.
    • "WALK" ist die Mobilitätsform für Fußgängerrouten.
  • usages ist eine Liste der vom Navigationspunkt unterstützten Verwendungen. Die Nutzung kann Folgendes umfassen:
    • "DROPOFF"
    • "PICKUP"
    • "PARKING"

Verwenden Sie für Abhol- und Abgabeorte den Navigationspunkt, bei dem die Mobilitätsform DRIVE und die Nutzung 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. Wenn es vertikal gestapelte Straßensegmente gibt, können Sie mit dem Feld altitude_meters das beste Straßensegment für die Navigation auswählen.

landmarks

Wichtige Orte in der Nähe, damit Nutzer die Umgebung des Zielorts besser kennenlernen.

Jede Markierung enthält die folgenden Felder:

  • place ist das PlaceView-Objekt, das dieses Wahrzeichen darstellt.
  • relationalDescription ist eine menschenlesbare Beschreibung, wie das Ziel mit der Sehenswürdigkeit zusammenhängt, z. B. „In der Nähe des Empire State Building“ oder „Gegenüber dem Weißen Haus“.
  • tags[] ist ein Array von Tags, die beschreiben, wie die Sehenswürdigkeit im Kontext des Ziels verwendet werden kann:
    • "ADDRESS": Ein lokal bekannter Ort, der verwendet werden kann, um den ungefähren Standort des Ziels zu identifizieren.
    • "ARRIVAL": Ein Ort, der als Orientierungshilfe dienen kann, um das Ziel zu erreichen. Er ist nützlich für die Navigation, wenn Sie sich in der Nähe des Ziels befinden.
  • straightLineDistanceMeters ist die Luftlinie von diesem Orientierungspunkt zum Ziel in Metern.
  • travelDistanceMeters ist die Entfernung in Metern, die zu Fuß von diesem Orientierungspunkt zum Ziel zurückgelegt werden muss.

arrivalSummary

KI-basierte Informationen zur Unterstützung bei der Ankunft. Weitere Informationen finden Sie unter KI-basierte Zusammenfassungen.

parkingOptions

Detaillierte Parkplatzinformationen.

Antwortformat

„SearchDestinations“ gibt ein 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

  • Die API-Anfrage muss einen der folgenden drei Parameter enthalten, mit denen die Adresse, der Ort oder die Position für die Suche nach einem Ziel angegeben wird:
    • addressQuery: die Adresse, nach der gesucht werden soll.
    • place: die Orts-ID des Ortes, nach dem gesucht werden soll.
    • locationQuery: Die Breiten- und Längengradkoordinaten 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 Antwortfeldmaske erstellen. Übergeben Sie die Antwortfeldmaske mit dem URL-Parameter $fields oder fields oder mit dem HTTP-Header X-Goog-FieldMask an die Methode. Mit der folgenden Anfrage werden beispielsweise nur die Eingänge, Navigationspunkte und die Orts-ID des Hauptziels zurückgegeben.

      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. Legen Sie die Feldmaske auf * fest, 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.

    • Hier finden Sie eine Liste der unterstützten Sprachen. Die unterstützten Sprachen werden regelmäßig von Google aktualisiert, sodass diese Liste unter Umständen nicht vollständig ist.
    • Wenn languageCode nicht angegeben wird, verwendet die API standardmäßig die lokale Sprache und das lokale Schriftsystem des Standorts. Wenn Sie einen ungültigen Sprachcode angeben, gibt die API den Fehler INVALID_ARGUMENT zurück.
    • Die API versucht, eine Adresse anzugeben, die sowohl für den Nutzer als auch für Einheimische lesbar ist. Dazu werden Straßenadressen in der Landessprache zurückgegeben, die bei Bedarf in ein für den Nutzer lesbares Schriftsystem transliteriert werden. Dabei wird die bevorzugte Sprache berücksichtigt. Alle anderen Adressen werden in der bevorzugten Sprache zurückgegeben. Adresskomponenten werden alle in derselben Sprache zurückgegeben, die von der ersten Komponente ausgewählt wird.
    • Wenn ein Name in der bevorzugten Sprache nicht verfügbar ist, wird die nächstgelegene Übereinstimmung verwendet.
    • Die bevorzugte Sprache hat einen geringen Einfluss auf die Menge der Ergebnisse, die von der API zurückgegeben werden, 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 sind mit den ISO 3166-1-Codes identisch.

    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. Wenn Sie einen Ort oder eine Adresse geocodieren, umgekehrt geocodieren oder geocodieren, können Sie diesen Parameter verwenden, um die Adresse zu formatieren. In allen Fällen kann dieser Parameter die Ergebnisse gemäß geltendem Recht beeinflussen.

  • placeFilter

    Damit können Sie die Ergebnisse einer locationQuery-Suche filtern, um Ihre Anforderungen zu erfüllen, z. B. nur Ziele zurückzugeben, die Gebäude sind, oder nur Ziele mit eindeutigen Adressen.

    Nach struktureller Granularität filtern

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

    • Gebäude isolieren: Mit "structureType": "BUILDING" können Sie Gebäudeumrisse auf einer Karte anzeigen oder Details zu einem bestimmten Gebäude abrufen.
    • Komplexe verstehen: Verwende "structureType": "GROUNDS", um sicherzustellen, dass das primäre Ergebnis das gesamte Gelände ist. Das ist nützlich, wenn Sie größere Bereiche wie Universitätsgelände oder Einkaufszentren abfragen.
    • Fokus auf Einheiten/Abschnitte: Verwenden Sie "structureType": "SECTION", um Abschnitte innerhalb eines Gebäudes zu identifizieren.

    Nützliche Adressen bereitstellen

    Nicht alle Orte haben eindeutige Adressen auf Straßenebene. Mit dem Filter addressability können Sie die Qualität der Adressen in den Ergebnissen 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 die Navigation oder Anzeige, wenn eine eindeutige Adresse wichtig ist.
    • Adressen in untergeordneten Zielen zulassen: Wenn der primäre Ort keine Adresse hat, aber Einheiten darin (z. B. Wohnungen in einem Gebäude), sorgt "addressability": "WEAK" dafür, dass zumindest der primäre Ort oder eines seiner untergeordneten Ziele eine Adresse hat.
    • Beliebiges Ergebnis: Wenn das Vorhandensein einer Adresse 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 die Genauigkeit dieser Ergebnisse dadurch verbessert wird.
    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