Link zu Google Maps

Die Places API (New) akzeptiert Anfragen für Ortsdaten über verschiedene Methoden. Die Antwort der Places API (New) enthält Daten zu einem Ort, darunter Standortdaten und Bilder, geografische Standorte und wichtige POIs.

Die Antwort von „Text Search (New)“, „Nearby Search (New)“ und „Place Details (New)“ kann auch Links zu Google Maps enthalten. Ihre Nutzer können diese Google Maps-Links aufrufen, um zusätzliche Informationen zu einem Ort in der Antwort zu sehen.

Sie suchen beispielsweise nach Flughäfen in San Francisco, Kalifornien. Die Antwort enthält dann den San Francisco International Airport (SFO) in der Liste der Orte. Das Place-Objekt für SFO in der Antwort fügt das Feld googleMapsUri hinzu, das Google Maps-Links enthält, um Google Maps für den Ort zu öffnen, Wegbeschreibungen zum Ort, Rezensionen des Orts und Fotos des Orts.

Zusammen mit den Links, die dem Place-Objekt hinzugefügt wurden, wird auch das Feld googleMapsUri den Objekten Reviews und Photos in der Antwort hinzugefügt:

• Reviews.googleMapsUri: Enthält einen Google Maps-Link zur Rezension, damit Sie sie in einem Browser aufrufen können.

• Photos.googleMapsUri: Enthält einen Google Maps-Link zum Foto, damit Sie es in einem Browser ansehen können.

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

Testen!

Unterstützte Google Maps-Links für einen Ort

In der folgenden Tabelle sind die Google Maps-Links aufgeführt, die Sie in die Antwort einfügen können:

Alle Links in die Antwort von Google Places aufnehmen

Die Links in der Antwort für Orte sind im Feld googleMapsLinks enthalten. Achten Sie darauf, das Feld googleMapsLinks in die Feldmaske der Anfrage aufzunehmen, wenn es in der Antwort angezeigt werden soll.

Die folgende Text Search (New) enthält beispielsweise alle Maps-Links in der Antwort:

curl -X POST -d '{
  "textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks' \
'https://places.googleapis.com/v1/places:searchText'

Die Antwort hat das folgende Format:

{
  "places": [
    {
      "formattedAddress": "San Francisco, CA 94128, USA",
      "displayName": {
        "text": "San Francisco International Airport",
        "languageCode": "en"
      },
      "googleMapsLinks": {
        "placeUri": "https://maps.google.com/?cid=11885663895765773631",
        "directionsUri": "https://www.google.com/maps/dir//''/data=!4m7!4m6!1m1!4e2!1m2!1m1!1s0x808f778c55555555:0xa4f25c571acded3f!3e0",
        "writeAReviewUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!12e1",
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x808f778c55555555:0xa4f25c571acded3f!9m1!1b1",
        "photosUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!10e5"
      }
    }
  ]
}

Einen bestimmten Link in die Antwort einfügen

Sie müssen nicht alle Links in der Antwort zurückgeben. Wenn Sie beispielsweise nur den Link zu Fotos in der Antwort erhalten möchten, ändern Sie die Feldmaske wie unten dargestellt, um nur das Feld photosUri einzuschließen:

curl -X POST -d '{
  "textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks.photosURI' \
'https://places.googleapis.com/v1/places:searchText'

Wegbeschreibung in die Antwort aufnehmen

Alle Places-Methoden unterstützen die Generierung des Routenlinks in der Antwort. Der aktuelle Standort wird als Ausgangspunkt, der Ort als Ziel und das Verkehrsmittel „Auto“ verwendet.

Im nächsten Beispiel wird „Nearby Search (New)“ verwendet, um den Link zur Wegbeschreibung in Google Maps in der Antwort im Feld directionsUri einzufügen:

curl -X POST -d '{
  "includedTypes": ["restaurant"],
  "maxResultCount": 10,
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": -33.8688,
        "longitude": 151.1957362},
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key:API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.googleMapsLinks.directionsUri' \
https://places.googleapis.com/v1/places:searchNearby

Links zu Rezensionen und Fotos einfügen

In dieser Version wird das Feld googleMapsUri den Objekten Reviews und Photos in der Antwort hinzugefügt. Wenn Sie diese Links aufrufen, werden die Rezension oder das Foto in Google Maps geöffnet.

Die folgende Textsuche (neu) enthält beispielsweise Rezensionen und Fotos für jeden Ort in der Antwort:

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.reviews,places.photos' \
'https://places.googleapis.com/v1/places:searchText'

In der Antwort enthält jedes Element des Arrays „reviews“ und „photos“ das Feld googleMapsUri, um die Rezension oder das Foto in einem Browser zu öffnen.

Testen!

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

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

2. Optional können Sie Standardparameter anzeigen maximieren und den Parameter fields auf die Feldmaske festlegen.

3. Bearbeiten Sie optional den Anfragetext.

4. Klicken Sie auf die Schaltfläche Ausführen. Wählen Sie im Dialogfeld das Konto aus, das Sie für die Anfrage verwenden möchten.

5. Wählen Sie im Bereich „API Explorer“ die Option fullscreen aus.

   Vollbild, um das API Explorer-Fenster zu maximieren.