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, einschließlich Standortdaten und Bildern, geografischen Standorten und wichtigen 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-URLs aufrufen, um zusätzliche Informationen zu einem Ort in der Antwort zu erhalten.

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 enthält das Feld googleMapsUri mit Google Maps-Links, über die Google Maps für den Ort, die Wegbeschreibung zum Ort, Rezensionen zum Ort und Fotos des Orts geöffnet werden können.

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

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

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

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

Testen!

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

Google Maps-URL Beschreibung Feldname
Ort Link, um Google Maps für den Ort zu öffnen. googleMapsLinks.placeUri
Wegbeschreibung Link zum Öffnen der Wegbeschreibung zum Ort in Google Maps. googleMapsLinks.directionsUri
Rezension schreiben Link, über den Sie eine Rezension für den Ort in Google Maps schreiben können. googleMapsLinks.writeAReviewUri
Rezensionen lesen Link zu Google Maps-Rezensionen des Ortes. googleMapsLinks.reviewsUri
Fotos Link zum Anzeigen von Fotos des Ortes in Google Maps. googleMapsLinks.photosUri

Die Links in der Antwort zu Orten 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)-Anfrage enthält beispielsweise alle Maps-URLs 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 folgendes 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"
      }
    }
  ]
}

Sie müssen nicht alle Links in der Antwort zurückgeben. Wenn Sie beispielsweise nur den Fotolink in der Antwort haben möchten, ändern Sie die Feldmaske wie unten gezeigt, sodass nur das Feld photosUri enthalten ist:

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'

Wegbeschreibungen in die Antwort aufnehmen

Alle Places-Methoden unterstützen die Generierung des Routenlinks in der Antwort. Der aktuelle Standort wird als Ausgangspunkt, der Standort des Ortes als Ziel und die Fortbewegungsart „Fahren“ verwendet.

Im nächsten Beispiel wird Nearby Search (New) verwendet, um den Link zur Routenplanung in Google Maps in das Feld directionsUri der Antwort aufzunehmen:

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

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

Die folgende Text Search (New)-Anfrage 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, über das die Rezension oder das Foto in einem Browser geöffnet werden kann.

Testen!

Mit dem API 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 aus.

  2. Maximieren Sie optional Standardparameter anzeigen und legen Sie den Parameter fields auf die Feldmaske fest.

  3. Bearbeiten Sie optional den Anfragetext.

  4. 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.

  5. Wählen Sie im API Explorer-Bereich aus.

    Vollbild, um das API Explorer-Fenster zu maximieren.