Link zu Google Maps

Die Places API (New) akzeptiert Anfragen zu Ortsdaten über eine Vielzahl von Methoden. Die Antwort der Places API (New) enthält Daten zu einem Ort, einschließlich Standortdaten und Bildmaterial, geografische Standorte und wichtige Points of Interest.

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

Beispiel: 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. Das Place Objekt für SFO in der Antwort enthält das Feld googleMapsUri mit Google Maps-Links, um Google Maps für den Ort zu öffnen, eine Wegbeschreibung zum Ort abzurufen, Rezensionen zum Ort zu lesen und Fotos des Ortes anzusehen.

Neben 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 einen Google Maps-Link zur Rezension, damit Sie sie in einem Browser ansehen 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 diesen 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 Places-Antwort einfügen

Die Links in der Places-Antwort sind im googleMapsLinks Feld enthalten. Wenn sie in der Antwort angezeigt werden sollen, müssen Sie das Feld googleMapsLinks in die Feldmaske der Anfrage einfügen.

Die folgende „Text Search (New)“-Anfrage 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 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"
      }
    }
  ]
}

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 den Fotos in der Antwort haben möchten, ändern Sie die Feldmaske wie unten gezeigt, um nur das Feld photosUri einzufügen:

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 einfügen

Alle Places-Methoden unterstützen die Generierung des Links zur Wegbeschreibung in der Antwort. Der aktuelle Standort wird als Ausgangspunkt, der Standort des Ortes als Ziel und der Reisemodus als „Mit dem Auto“ verwendet.

Im nächsten Beispiel wird „Nearby Search (New)“ verwendet, um den Link zur Wegbeschreibung 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 „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 für Rezensionen und Fotos 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. Erweitern Sie optional Standardparameter anzeigen und legen Sie für den Parameter fields die Feldmaske fest.

3. Bearbeiten Sie optional den Anfragetext.

4. Wählen Sie die Schaltfläche 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 fullscreen aus.

   Vollbildmodus , um das API Explorer-Fenster zu maximieren.