Ortsdetails (neu)

Einführung

Wenn Sie eine Orts-ID haben, können Sie mit einer Place Details (New)-Anfrage weitere Details zu einer bestimmten Einrichtung oder einem bestimmten POI anfordern. Eine Place Details (New)-Anfrage gibt umfassendere Informationen zum angegebenen Ort zurück, z. B. die vollständige Adresse, die Telefonnummer, die Nutzerbewertung und Rezensionen.

Es gibt viele Möglichkeiten, eine Orts-ID abzurufen. Sie können Folgendes angeben:

• Text Search (New) oder Nearby Search (New)
• Geocoding API
• Routes API
• Address Validation API
• Automatische Vervollständigung (neu)

Mit dem APIs Explorer können Sie Liveanfragen stellen, um sich mit der API und den API-Optionen vertraut zu machen:

Place Details (New)-Anfragen

Eine Place Details (New)-Anfrage ist eine HTTP-GET-Anfrage im folgenden Format:

https://places.googleapis.com/v1/places/PLACE_ID

Übergeben Sie alle Parameter als URL-Parameter oder in Headern als Teil der GET-Anfrage. Beispiel:

https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=API_KEY

Oder in einem curl-Befehl:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

„Place Details (New)“-Antworten

Place Details (New) gibt ein JSON-Objekt als Antwort zurück. Die Antwort sieht so aus:

• Die Antwort wird durch ein Place-Objekt dargestellt. Das Place-Objekt enthält detaillierte Informationen zum Ort.
• Die in der Anfrage übergebene FieldMask gibt die Liste der Felder an, die im Place-Objekt zurückgegeben werden.

Das vollständige JSON-Objekt hat folgendes Format:

{
  "name": "places/ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "id": "ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "displayName": {
    "text": "Trinidad"
  }
  ...
}

Erforderliche Parameter

• 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. In der Antwort gibt es keine Standardliste der zurückgegebenen Felder. Wenn Sie die Feldmaske weglassen, gibt die Methode einen Fehler zurück.

  Mit der Maskierung von Feldern lässt sich verhindern, dass unnötige Daten angefordert werden, was wiederum hilft, unnötige Verarbeitungszeiten und Gebühren zu vermeiden.

  Geben Sie eine durch Kommas getrennte Liste der Ortsdatentypen an, die zurückgegeben werden sollen. Beispielsweise, um den Anzeigenamen und die Adresse des Ortes abzurufen.

  X-Goog-FieldMask: displayName,formattedAddress

  Verwenden Sie *, um alle Felder abzurufen.

  X-Goog-FieldMask: *

  Geben Sie eines oder mehrere der folgenden Felder an:

  • Die folgenden Felder lösen die SKU „Place Details Essentials IDs Only“ aus:

    attributions
consumerAlert
id
movedPlace
movedPlaceId
name^*
    photos
    

    ^* Das Feld name enthält den Ressourcennamen des Orts in folgendem Format: places/PLACE_ID. Wenn Sie den Textnamen des Orts abrufen möchten, fordern Sie das Feld displayName in der Pro-SKU an.

    Eine vollständige Liste der Felder und der zugehörigen SKUs finden Sie unter Ortsdatenfelder (neu).

  • Die folgenden Felder lösen die SKU Place Details Essentials aus:

    addressComponents
addressDescriptor^*
    adrFormatAddress
formattedAddress
location
plusCode
postalAddress
shortFormattedAddress
types
viewport
    
    ^* Adressbeschreibungen sind für Kunden in Indien allgemein verfügbar und werden anderswo experimentell eingesetzt.
    
    

    Eine vollständige Liste der Felder und der zugehörigen SKUs finden Sie unter Ortsdatenfelder (neu).

  • Die folgenden Felder lösen die SKU Place Details Pro aus:

    accessibilityOptions
businessStatus
containingPlaces
displayName
googleMapsLinks
googleMapsTypeLabel
googleMapsUri
iconBackgroundColor
iconMaskBaseUri
openingDate
primaryType
primaryTypeDisplayName
pureServiceAreaBusiness
subDestinations
timeZone
utcOffsetMinutes
    
    

    Eine vollständige Liste der Felder und der zugehörigen SKUs finden Sie unter Ortsdatenfelder (neu).

  • Die folgenden Felder lösen die Place Details Enterprise-SKU aus:

    currentOpeningHours
currentSecondaryOpeningHours
internationalPhoneNumber
nationalPhoneNumber
priceLevel
priceRange
rating
regularOpeningHours
regularSecondaryOpeningHours
transitStation
userRatingCount
websiteUri

    Eine vollständige Liste der Felder und der zugehörigen SKUs finden Sie unter Ortsdatenfelder (neu).

  • Die folgenden Felder lösen die SKU Place Details Enterprise + Atmosphere aus:

    allowsDogs
curbsidePickup
delivery
dineIn
editorialSummary
evChargeAmenitySummary
evChargeOptions
fuelOptions
generativeSummary
goodForChildren
goodForGroups
goodForWatchingSports
liveMusic
menuForChildren
neighborhoodSummary
parkingOptions
paymentOptions
outdoorSeating
reservable
restroom
reviews
reviewSummary
routingSummaries^*
    servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDessert
servesDinner
servesLunch
servesVegetarianFood
servesWine
takeout
    
    ^* Nur Text Search und Nearby Search

    Eine vollständige Liste der Felder und der zugehörigen SKUs finden Sie unter Ortsdatenfelder (neu).

• placeId

  Eine ID in Textform, die einen Ort eindeutig identifiziert und von Text Search (New) oder Nearby Search (New) zurückgegeben wird. Weitere Informationen finden Sie in der Übersicht zur Orts-ID.

  Der String places/PLACE_ID wird auch als Ressourcenname des Orts bezeichnet. In der Antwort auf eine „Place Details (New)“-, „Nearby Search (New)“- und „Text Search (New)“-Anfrage ist dieser String im Feld name der Antwort enthalten. Die eigenständige Orts-ID ist im Feld id der Antwort enthalten.

Optionale Parameter

• 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 ist, wird standardmäßig en verwendet. 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 Adressen in der Landessprache zurückgegeben, die bei Bedarf in eine für den Nutzer lesbare Schrift transkribiert 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, verwendet die API die nächstgelegene Übereinstimmung.
  • Die bevorzugte Sprache hat einen geringen Einfluss auf die von der API zurückgegebenen Ergebnisse und die Reihenfolge, in der sie zurückgegeben werden. Der Geocoder interpretiert Abkürzungen je nach Sprache unterschiedlich, z. B. Abkürzungen für Straßentypen oder Synonyme, die in einer Sprache gültig sind, in einer anderen jedoch nicht.

• regionCode

  Der Regionscode, der zum Formatieren der Antwort verwendet wird, angegeben als zweistelliger CLDR-Code. Es gibt keinen Standardwert.

  Wenn der Ländername des Felds formattedAddress in der Antwort mit dem regionCode übereinstimmt, wird der Ländercode in formattedAddress weggelassen. Dieser Parameter hat keine Auswirkungen auf adrFormatAddress, das immer den Ländernamen enthält, oder auf shortFormattedAddress, das ihn nie enthält.

  Die meisten CLDR-Codes sind mit den ISO 3166-1-Codes identisch, es gibt jedoch einige Ausnahmen. So lautet beispielsweise die ccTLD des Vereinigten Königreichs „uk“ (.co.uk), der ISO-3166-1-Code dagegen „gb“ (technisch gesehen für das Vereinigte Königreich Großbritannien und Nordirland). Der Parameter kann sich je nach anwendbarem Recht auf die Ergebnisse auswirken.

• sessionToken

  Sitzungstokens sind vom Nutzer generierte Strings, mit denen Autocomplete (New)-Aufrufe als „Sitzungen“ erfasst werden. Bei Autocomplete (New) werden Sitzungstokens verwendet, um die Abfrage- und Ortsauswahlphasen einer Nutzeranfrage zur automatischen Vervollständigung zu Abrechnungszwecken zu einer separaten Sitzung zusammenzufassen. Sitzungstokens werden an „Place Details (New)“-Aufrufe übergeben, die auf „Autocomplete (New)“-Aufrufe folgen. Weitere Informationen finden Sie unter Sitzungstokens.

Beispiel für „Place Details (New)“

Im folgenden Beispiel werden die Details eines Ortes anhand der placeId angefordert:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

Beachten Sie, dass im Header X-Goog-FieldMask angegeben ist, dass die Antwort die folgenden Datenfelder enthält: id,displayName. Die Antwort hat dann folgendes Format:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

Fügen Sie der Feldmaske weitere Datentypen hinzu, um zusätzliche Informationen zurückzugeben. Fügen Sie beispielsweise formattedAddress,plusCode hinzu, um die Adresse und den Plus Code in die Antwort aufzunehmen:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,formattedAddress,plusCode" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

Die Antwort hat jetzt folgendes Format:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
  "plusCode": {
    "globalCode": "849VCWC7+RW",
    "compoundCode": "CWC7+RW Mountain View, CA, USA"
  },
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

Bewertungen, Anzahl der Rezensionen und Rezensionen abrufen

Wenn Sie die durchschnittliche Sternebewertung, die Gesamtzahl der Bewertungen (Rezensionen insgesamt) oder den Text der Kundenrezensionen eines Unternehmens abrufen möchten, fügen Sie die entsprechenden Felder in den Header X-Goog-FieldMask ein:

• rating und userRatingCount: Gibt die durchschnittliche Bewertung des Ortes (von 1.0 bis 5.0) und die Gesamtzahl der Rezensionen zurück. Wenn Sie diese Felder anfordern, wird die Place Details Enterprise-SKU ausgelöst.
• reviews und reviewSummary: Gibt bis zu fünf von Nutzern eingereichte Review-Objekte und eine KI-generierte Zusammenfassung der Rezensionen zurück. Wenn Sie diese Felder anfordern, wird die SKU Place Details Enterprise + Atmosphere ausgelöst.

Wenn Ihre App nur die Sternebewertung und die Gesamtzahl der Rezensionen benötigt, fordern Sie rating und userRatingCount ohne reviews an, damit die Anfrage in der Stufe Place Details Enterprise SKU bleibt:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,rating,userRatingCount" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

Wenn Sie auch bis zu fünf von Nutzern eingereichte Review-Objekte abrufen möchten, fügen Sie der Feldmaske reviews hinzu. Die Abrechnung erfolgt dann auf der Stufe Place Details Enterprise + Atmosphere SKU:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,rating,userRatingCount,reviews" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

Die Antwort enthält die Bewertung, die Gesamtzahl der Bewertungen und das Array reviews:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  },
  "rating": 4.2,
  "userRatingCount": 2594,
  "reviews": [
    {
      "name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/reviews/...",
      "relativePublishTimeDescription": "a month ago",
      "rating": 5,
      "text": {
        "text": "Iconic tech campus with visitor areas and cafes.",
        "languageCode": "en"
      },
      "authorAttribution": {
        "displayName": "Alex Rivera"
      }
    }
  ]
}

Adressdeskriptoren abrufen

Adressdeskriptoren liefern relationale Informationen zur Lage eines Ortes, einschließlich Sehenswürdigkeiten in der Nähe und umliegender Gebiete.

Das folgende Beispiel zeigt eine Place Details (New)-Anfrage für ein Kaufhaus in einem Einkaufszentrum in San Jose. In diesem Beispiel fügen Sie addressDescriptors in die Feldmaske ein:

  curl -X GET https://places.googleapis.com/v1/places/ChIJ8WvuSB7Lj4ARFyHppkxDRQ4 \
  -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
  -H "X-Goog-FieldMask: name,displayName,addressDescriptor"

Die Antwort enthält den in der Anfrage angegebenen Ort, eine Liste der Sehenswürdigkeiten in der Nähe und ihre Entfernung zum Ort sowie eine Liste der Gebiete und ihre Beziehung zum Ort:

  {
    "name": "places/ChIJ8WvuSB7Lj4ARFyHppkxDRQ4",
    "displayName": {
      "text": "Macy's",
      "languageCode": "en"
    },
    "addressDescriptor": {
      "landmarks": [
        {
          "name": "places/ChIJVVVVUB7Lj4ARXyb4HFVDV8s",
          "placeId": "ChIJVVVVUB7Lj4ARXyb4HFVDV8s",
          "displayName": {
            "text": "Westfield Valley Fair",
            "languageCode": "en"
          },
          "types": [
            "clothing_store",
            "department_store",
            "establishment",
            "food",
            "movie_theater",
            "point_of_interest",
            "restaurant",
            "shoe_store",
            "shopping_mall",
            "store"
          ],
          "spatialRelationship": "WITHIN",
          "straightLineDistanceMeters": 220.29175
        },
        {
          "name": "places/ChIJ62_oCR7Lj4AR_MGWkSPotD4",
          "placeId": "ChIJ62_oCR7Lj4AR_MGWkSPotD4",
          "displayName": {
            "text": "Nordstrom",
            "languageCode": "en"
          },
          "types": [
            "clothing_store",
            "department_store",
            "establishment",
            "point_of_interest",
            "shoe_store",
            "store"
          ],
          "straightLineDistanceMeters": 329.45178
        },
        {
          "name": "places/ChIJmx1c5x7Lj4ARJXJy_CU_JbE",
          "placeId": "ChIJmx1c5x7Lj4ARJXJy_CU_JbE",
          "displayName": {
            "text": "Monroe Parking Garage",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "parking",
            "point_of_interest"
          ],
          "straightLineDistanceMeters": 227.05153
        },
        {
          "name": "places/ChIJxcwBziHLj4ARUQLAvtzkRCM",
          "placeId": "ChIJxcwBziHLj4ARUQLAvtzkRCM",
          "displayName": {
            "text": "Studios Inn by Daiwa Living California Inc.",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "lodging",
            "point_of_interest",
            "real_estate_agency"
          ],
          "straightLineDistanceMeters": 299.9955
        },
        {
          "name": "places/ChIJWWIlNx7Lj4ARpe1E0ob-_GI",
          "placeId": "ChIJWWIlNx7Lj4ARpe1E0ob-_GI",
          "displayName": {
            "text": "Din Tai Fung",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "food",
            "point_of_interest",
            "restaurant"
          ],
          "straightLineDistanceMeters": 157.70943
        }
      ],
      "areas": [
        {
          "name": "places/ChIJb3F-EB7Lj4ARnHApQ_Hu1gI",
          "placeId": "ChIJb3F-EB7Lj4ARnHApQ_Hu1gI",
          "displayName": {
            "text": "Westfield Valley Fair",
            "languageCode": "en"
          },
          "containment": "WITHIN"
        },
        {
          "name": "places/ChIJXYuykB_Lj4AR1Ot8nU5q26Q",
          "placeId": "ChIJXYuykB_Lj4AR1Ot8nU5q26Q",
          "displayName": {
            "text": "Valley Fair",
            "languageCode": "en"
          },
          "containment": "WITHIN"
        },
        {
          "name": "places/ChIJtYoUX2DLj4ARKoKOb1G0CpM",
          "placeId": "ChIJtYoUX2DLj4ARKoKOb1G0CpM",
          "displayName": {
            "text": "Central San Jose",
            "languageCode": "en"
          },
          "containment": "WITHIN"
        }
      ]
    }
  }

Ortsdetails für einen verschobenen Ort abrufen

Wenn ein Ort, auf den in Ihrer App verwiesen wird, umgezogen ist, können Sie die Felder movedPlace und movedPlaceId verwenden, um die Details des neuen Orts abzurufen.

Für Orte, die dauerhaft geschlossen sind, gibt „Place Details (New)“ im Feld businessStatus den Wert CLOSED_PERMANENTLY zurück und lässt die Felder movedPlace und movedPlaceId im Antworttext weg.

Für Orte, die umgezogen sind, gibt „Place Details (New)“ im Feld businessStatus den Wert CLOSED_PERMANENTLY und im Antworttext in den Feldern movedPlace und movedPlaceId den neuen Standort zurück.

Für Orte, die nicht umgezogen sind, werden in der Antwort von Place Details (New) weder movedPlace noch movedPlaceId zurückgegeben.

Im folgenden Beispiel werden Ortsinformationen zu Marche IGA St-Canut in Quebec, Kanada, angefordert:

curl -X  GET -H 'Content-Type: application/json' \
-H 'x-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: id,displayName,businessStatus,movedPlace,movedPlaceId' \
https://places.googleapis.com/v1/places/ChIJUfQdGInVzkwRzAjmjzWB7CQ

Die Anfrage gibt die folgende Antwort zurück:

{
  "id": "ChIJUfQdGInVzkwRzAjmjzWB7CQ",
  "businessStatus": "CLOSED_PERMANENTLY",
  "displayName": {
    "text": "Marche IGA St-Canut",
    "languageCode": "en"
  },
  "movedPlace": "places/ChIJ36QT7n8qz0wRDqVZ_UBlUlQ",
  "movedPlaceId": "ChIJ36QT7n8qz0wRDqVZ_UBlUlQ"
}

Wenn Sie Details zum neuen Ort anfordern möchten, verwenden Sie den Ressourcennamen des Orts im Feld movedPlace einer neuen „Place Details (New)“-Anfrage.

Bei Orten, die mehrmals umgezogen sind, sind möglicherweise mehrere verkettete Place Details (New)-Anfragen erforderlich, um Details zum aktuellen Standort zu erhalten. Die Felder movedPlace und movedPlaceId eines Ortsergebnisses verweisen nur auf den nächsten Standort, nicht auf den letzten bekannten Standort. Ein Ort befindet sich an seinem aktuellen Standort, wenn in einer „Place Details (New)“-Anfrage die Felder movedPlace und movedPlaceId im Antworttext weggelassen werden.

Unternehmen finden, die in Zukunft eröffnen

Sie können Details zu Unternehmen anfordern, die voraussichtlich in Zukunft eröffnet werden. Bei der Nearby Search (New) wird das Feld openingDate ausgefüllt, wenn das voraussichtliche Eröffnungsdatum mindestens den Monat enthält und weniger als 90 Tage entfernt ist.

Das folgende Beispiel zeigt eine Nearby Search (New)-Anfrage für ein Unternehmen, das in Zukunft in New Meadows, Idaho, USA, eröffnet wird:

curl -X GET \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,businessStatus,openingDate" \
"https://places.googleapis.com/v1/places/ChIJp1-VoKWJplQRMz8g-7Wa3Do"

Die Antwort enthält den Betriebsstatus und das voraussichtliche Eröffnungsdatum des Ortes:

{
  "id": "ChIJp1-VoKWJplQRMz8g-7Wa3Do",
  "businessStatus": "FUTURE_OPENING",
  "openingDate": {
    "year": 2026,
    "month": 4,
    "day": 15
  }
}

Informationen zu Bahnhöfen und Haltestellen abrufen

Mit Place Details (New) können Sie Informationen zu Haltestellen abrufen. Der Antworttext enthält Informationen zur Station, einschließlich des Stationsnamens, der zugehörigen Verkehrsverbünde und der ÖPNV-Linien, die die Station bedienen. Außerdem enthält die Antwort ein Fahrzeugsymbol und Farben, die Sie verwenden können, um die Informationen zur Haltestelle anzuzeigen.

Das folgende Beispiel zeigt eine Anfrage für Informationen zur Haltestelle Grand Central Station:

curl -X GET \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,transitStation" \
"https://places.googleapis.com/v1/places/ChIJLVaKiQFZwokRgcybX3K6Pzg"

Der Antworttext enthält Informationen zu jeder Haltestelle im Umkreis, zu den Linien, die die Haltestelle bedienen, zu den Meldungen, die von den Betreibern an dieser Haltestelle ausgegeben werden, und zu den Abfahrtszeiten:

  {
  "id": "ChIJLVaKiQFZwokRgcybX3K6Pzg",
  "displayName": {
    "text": "Grand Central",
    "languageCode": "en"
  },
  "transitStation": {
    "displayName": {
      "text": "Grand Central",
      "languageCode": "en"
    },
    "agencies": [
      {
        "displayName": {
          "text": "MTA New York City Transit",
          "languageCode": "en"
        },
        "url": "http://www.mta.info/",
        "lines": [
          {
            "id": "ChIJ420yFwBZwokR903kVZLSsFc",
            "vehicleType": "SUBWAY",
            "displayName": {
              "text": "42 St Shuttle",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "S",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#808183",
            "url": "https://www.mta.info/schedules/subway/42-st-shuttle",
            "icon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/us-ny-mta/S.svg",
              "nameIncluded": true
            },
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/subway2.svg"
            }
          },
          {
            "id": "ChIJDdd_uEdfwokRHbLvWrdBdDM",
            "vehicleType": "SUBWAY",
            "displayName": {
              "text": "5 Train (Lexington Av Express)",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "5 Line",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#00933C",
            "url": "https://www.mta.info/schedules/subway/5-train",
            "icon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/us-ny-mta/5.svg",
              "nameIncluded": true
            },
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/subway2.svg"
            }
          }
          ...
        ]
      },
      {
        "displayName": {
          "text": "MTA",
          "languageCode": "en"
        },
        "url": "https://new.mta.info/",
        "lines": [
          {
            "id": "ChIJcwVpzKpZwokR24EBeh8arww",
            "vehicleType": "BUS",
            "displayName": {
              "text": "United Nations - W 42 St Pier",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "M42",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#1D59B3",
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/bus2.svg"
            }
          }
        ]
      },
      {
        "displayName": {
          "text": "Long Island Rail Road",
          "languageCode": "en"
        },
        "url": "http://www.mta.info/lirr",
        "lines": [
          {
            "id": "ChIJv9m8uWM56IkRUcVBQ6Q_In0",
            "vehicleType": "HEAVY_RAIL",
            "displayName": {
              "text": "Ronkonkoma Branch",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "LIRR",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#A626AA",
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/rail2.svg"
            }
          }
          ...
        ]
      }
    ],
    "stops": [
      {
        "id": "ChIJRcemlf1YwokRhFqqw5jKBFM",
        "stopCode": {
          "text": "GCT"
        },
        "location": {
          "latitude": 40.755161,
          "longitude": -73.975456
        },
        "wheelchairAccessibleEntrance": true
      },
      {
        "id": "ChIJ57l2zANZwokRD1pyhuwpfKY",
        "signageText": {
          "text": "34 St-Hudson Yards & Main St-Flushing, Queens, 7",
          "languageCode": "en"
        },
        "location": {
          "latitude": 40.750983,
          "longitude": -73.9750686
        },
        "wheelchairAccessibleEntrance": true
      },
      {
        "id": "ChIJoVXJgQFZwokR1yzq_WVuEuc",
        "displayName": {
          "text": "E 42 St/Park Av",
          "languageCode": "en"
        },
        "location": {
          "latitude": 40.7518199,
          "longitude": -73.9771918
        },
        "wheelchairAccessibleEntrance": true
      }
      ...
    ]
  }
}

Eingänge und Navigationspunkte abrufen

Sie können Eingänge und Navigationspunkte für ein Ziel anfordern. Eingänge definieren Ein- und Ausgänge für einen Ort (z. B. verschiedene Gates an einem Flughafen oder in einem Einkaufszentrum). Navigationspunkte definieren Orte am Straßenrand, an denen die Navigation enden soll. Das ist nützlich, um Nutzer zur richtigen Straßenseite oder zu einem bestimmten Absetzpunkt zu leiten.

Navigationspunkte geben einen navigationPointToken zurück. Sie können dieses Token an das Navigation SDK (verfügbar für Android oder iOS) oder die Routes API übergeben, um Fahrer zu diesem bestimmten Ort zu leiten. Weitere Informationen finden Sie unter Tokens für Navigationspunkte.

Im folgenden Beispiel werden Details zum San Francisco International Airport (Orts-ID ChIJVVVVVYx3j4ARP-3NGldc8qQ) angefordert, einschließlich entrances und navigationPoints in der Feldmaske:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,entrances,navigationPoints" \
https://places.googleapis.com/v1/places/ChIJVVVVVYx3j4ARP-3NGldc8qQ

Die Antwort enthält die Eingänge und Navigationspunkte für den Ort:

{
  "id": "ChIJVVVVVYx3j4ARP-3NGldc8qQ",
  "displayName": {
    "text": "San Francisco International Airport",
    "languageCode": "en"
  },
  "entrances": [
    {
      "location": {
        "latitude": 37.6172154,
        "longitude": -122.3839724
      }
    },
    {
      "location": {
        "latitude": 37.6174073,
        "longitude": -122.384196
      }
    },
    ...
  ],
  "navigationPoints": [
    {
      "navigationPointToken": "ChIJoioBjMLOQkAR0A3yH_eYXsA...",
      "displayName": {
        "text": "International Terminal Departures Level",
        "languageCode": "en"
      },
      "location": {
        "latitude": 37.6153121,
        "longitude": -122.3900833
      },
      "travelModes": ["WALK"]
    },
    {
      "navigationPointToken": "ChIJy5JKws_OQkAROx0jNN2YXsA...",
      "displayName": {
        "text": "Domestic Garage - SFO Short Term Parking",
        "languageCode": "en"
      },
      "location": {
        "latitude": 37.6157153,
        "longitude": -122.3885012
      },
      "travelModes": ["DRIVE", "WALK"],
      "usages": ["PARKING"]
    },
    ...
  ]
}

Testen!

Mit dem APIs Explorer können Sie Beispielanfragen erstellen, um sich mit der API und den API-Optionen vertraut zu machen.

1. Wählen Sie rechts auf der Seite das API-Symbol api aus.

2. Bearbeiten Sie optional die Anfrageparameter.

3. Wählen Sie den Button Ausführen aus. Wählen Sie im Dialogfeld das Konto aus, das Sie für die Anfrage verwenden möchten.

4. Wählen Sie im APIs Explorer-Bereich das Vollbildsymbol fullscreen aus, um das APIs Explorer-Fenster zu maximieren.