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.

Con questa release, la risposta di Ricerca testo (nuova), Ricerca nelle vicinanze (nuova) e Dettagli luogo (nuova) può contenere anche link a Google Maps. Gli 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. Con questa release, 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, questa release aggiunge 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 link di Google Maps alla foto per visualizzarla in un browser.

Explorer API ti consente di effettuare richieste live 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 nel luogo. googleMapsLinks.placeUri
Indicazioni stradali Link per aprire le indicazioni stradali per il luogo in Google Maps. googleMapsLinks.directionsUri
Scrivi recensione Link per scrivere una recensione del luogo in Google Maps. googleMapsLinks.writeAReviewUri
Leggi 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

Prezzi

Questa funzionalità è in fase di anteprima pre-GA e non prevede alcun costo, il che significa che la fatturazione è pari a 0 $per l'utilizzo durante l'anteprima. Per i dettagli sui prezzi proposti, consulta Utilizzo e fatturazione dell'API Places (nuova).

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 devi 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'oggetto della risposta. La posizione corrente viene utilizzata come origine, il luogo viene utilizzato 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 release aggiunge il campo googleMapsUri agli oggetti Reviews e Photos nella risposta. Se navighi su questi link, la recensione o la foto si aprono in 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

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

  1. Seleziona l'icona API, Espandi Explorer API., sul lato destro della pagina.

  2. (Facoltativo) Espandi Mostra parametri standard e imposta il parametro fields sulla maschera del 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 l'icona di espansione, Espandi Explorer API., per espandere la finestra di Explorer API.