Link a Google Maps

L'API Places (New) accetta richieste di dati sui luoghi tramite una serie di metodi. La risposta dell'API Places (New) contiene dati su un luogo, inclusi dati sulla posizione e immagini, posizioni geografiche e punti di interesse prominenti.

La risposta di Text Search (New), Nearby Search (New) e Place Details (New) può contenere anche link a Google Maps. I tuoi utenti possono accedere a questi link di Google Maps per visualizzare ulteriori informazioni su un luogo nella risposta.

Ad esempio, cerchi aeroporti a San Francisco, in California. La risposta include quindi il San Francisco International Airport (SFO) nell'elenco dei luoghi. L'oggetto Place per SFO nella risposta aggiunge il campo googleMapsUri contenente i link di Google Maps per aprire Google Maps nel luogo, le indicazioni stradali per il luogo, le recensioni del luogo e le foto del luogo.

Oltre ai link aggiunti all'oggetto Place, viene aggiunto anche il campo googleMapsUri agli oggetti Reviews e Photos nella risposta:

  • Reviews.googleMapsUri: contiene un link di Google Maps alla recensione, in modo che tu possa visualizzarla in un browser.

  • Photos.googleMapsUri: contiene un collegamento di Google Maps alla foto, così puoi visualizzarla in un browser.

L'API Explorer ti consente di effettuare richieste in tempo reale per familiarizzare con queste nuove opzioni:

Prova!

La seguente tabella mostra i link di Google Maps che puoi includere nella risposta:

Link di Google Maps Descrizione Nome campo
Luogo Link per aprire Google Maps sul luogo. googleMapsLinks.placeUri
Indicazioni stradali Link per aprire le indicazioni stradali per raggiungere il luogo su Google Maps. googleMapsLinks.directionsUri
Scrivi recensione Link per scrivere una recensione del posto su Google Maps. googleMapsLinks.writeAReviewUri
Leggere le recensioni Link per mostrare le recensioni di Google Maps del luogo. googleMapsLinks.reviewsUri
Foto Link per mostrare le foto del luogo in Google Maps. googleMapsLinks.photosUri

I link nella risposta dei luoghi sono contenuti nel campo googleMapsLinks. Assicurati di includere il campo googleMapsLinks nella maschera del campo della richiesta se vuoi che venga visualizzato nella risposta.

Ad esempio, la seguente ricerca di testo (nuova) include tutti i link di Maps nella risposta:

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'

La risposta è nel formato:

{
  "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"
      }
    }
  ]
}

Non è necessario restituire tutti i link nella risposta. Ad esempio, se vuoi solo il link alle foto nella risposta, modifica la maschera del campo come mostrato di seguito per includere solo il campo photosUri:

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'

Includere indicazioni nella risposta

Tutti i metodi Places supportano la generazione del link alle indicazioni nell'output. La posizione corrente viene utilizzata come origine, la posizione del luogo viene utilizzata come destinazione e la modalità di viaggio è in auto.

L'esempio successivo utilizza la ricerca nelle vicinanze (nuova) per includere il link alle indicazioni stradali di Maps nella risposta nel campo directionsUri:

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

Questa versione aggiunge il campo googleMapsUri agli oggetti Reviews e Photos nella risposta. Navigando su questi link si apre la recensione o la foto su Google Maps.

Ad esempio, la seguente ricerca di testo (nuova) include recensioni e foto per ogni luogo nella risposta:

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'

Nella risposta, ogni elemento dell'array di recensioni e foto contiene il campo googleMapsUri per aprire la recensione o la foto in un browser.

Prova

Explorer API ti consente di effettuare richieste di esempio per familiarizzare con l'API e le relative opzioni.

  1. Seleziona l'icona dell'API sul lato destro della pagina.

  2. (Facoltativo) Espandi Mostra parametri standard e imposta il parametro fields sulla maschera campo.

  3. (Facoltativo) Modifica il corpo della richiesta.

  4. Seleziona il pulsante Esegui. Nella finestra di dialogo, scegli l'account che vuoi utilizzare per effettuare la richiesta.

  5. Nel riquadro Explorer API, seleziona .

    A schermo intero per espandere la finestra di Explorer API.