Link zu Google Maps

Die Places API akzeptiert Anfragen für Ortsdaten über eine Vielzahl von Methoden. Die Places API-Antwort enthält Daten zu einem Ort, einschließlich Standortdaten und -bildern, geografischen Standorten und bekannten POIs.

Mit dieser Version können die Antworten der Textsuche, der Suche in der Nähe und von Place Details auch Links zu Google Maps enthalten. Ihre Nutzer können über diese Google Maps-Links zusätzliche Informationen zu einem Ort in der Antwort aufrufen.

Angenommen, Sie suchen nach Flughäfen in San Francisco, Kalifornien. Die Antwort enthält dann den San Francisco International Airport (SFO) in der Liste der Orte. Mit dieser Version wird dem Place-Objekt für SFO in der Antwort das Feld googleMapsUri hinzugefügt. Es enthält Google Maps-Links, über die Google Maps mit dem Ort geöffnet wird, sowie Wegbeschreibungen zum Ort, Rezensionen und Fotos des Orts.

Neben den Links, die dem Place-Objekt hinzugefügt wurden, wird in dieser Version 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.

Im API Explorer können Sie Liveanfragen stellen, um sich mit diesen neuen Optionen vertraut zu machen:

Testen!

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

Google Maps-Link Beschreibung Feldname
Ort Link, um Google Maps mit dem Ort zu öffnen. googleMapsLinks.placeUri
Directions Link zum Öffnen der Wegbeschreibung zum Ort in Google Maps. googleMapsLinks.directionsUri
Rezension schreiben Link zum Schreiben einer Rezension für den Ort in Google Maps googleMapsLinks.writeAReviewUri
Rezensionen lesen Link zu Google Maps-Rezensionen für den Ort googleMapsLinks.reviewsUri
Fotos Link, um Fotos des Ortes in Google Maps anzusehen. googleMapsLinks.photosUri

Preise

Diese Funktion befindet sich in der Pre-GA-Vorabversion und ist kostenlos. Das bedeutet, dass für die Nutzung während der Vorabversion keine Kosten anfallen. Weitere Informationen zu den vorgeschlagenen Preisen finden Sie unter Places API – Nutzung und Abrechnung.

Die Links in der Antwort zu Orten befinden sich im Feld googleMapsLinks. Fügen Sie das Feld googleMapsLinks in die Feldmaske der Anfrage ein, damit es in der Antwort erscheint.

Die folgende Textsuche enthält beispielsweise alle Google 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 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 Link zu den Fotos in der Antwort benötigen, ändern Sie die Feldmaske wie unten dargestellt, 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'

Wegbeschreibung in die Antwort aufnehmen

Alle Places-Methoden unterstützen die Generierung des Links zu den Wegbeschreibungen in der Antwort. Der aktuelle Standort wird als Startpunkt, der Standort des Orts als Ziel und der Verkehrsmitteltyp als „Auto“ verwendet.

Im nächsten Beispiel wird die Nearby Search verwendet, um den Link zu den Wegbeschreibungen 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

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 Textsuche 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-Symbol Maximieren Sie den API Explorer. aus.

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

  3. Optional können Sie den Anfragetext bearbeiten.

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

  5. Klicken Sie im API Explorer-Steuerfeld auf das Symbol zum Maximieren Maximieren Sie den API Explorer., um das Fenster des API Explorers zu maximieren.