Link a Google Maps

L'API Places accetta richieste di dati sui luoghi tramite diversi metodi. La risposta dell'API Places contiene dati su un luogo, inclusi dati sulla posizione e immagini, località geografiche e punti di interesse in evidenza.

Con questa release, la risposta della ricerca di testo, della ricerca nelle vicinanze e dei dettagli sul luogo può contenere anche link a Google Maps. Gli utenti possono visitare 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 l'aeroporto internazionale di San Francisco (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 al 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 a Google Maps per la recensione, in modo da poterla visualizzare in un browser.

  • Photos.googleMapsUri: contiene un link di Google Maps alla foto in modo da poterla visualizzare in un browser.

Explorer API 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 a Google Maps Descrizione Nome campo
Luogo Link per aprire Google Maps e visualizzare il luogo. googleMapsLinks.placeUri
Directions 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à è nella 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 informazioni dettagliate sui prezzi proposti, consulta Utilizzo e fatturazione dell'API Places.

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

Ad esempio, la seguente ricerca di testo 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 seguente 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 di 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'

Includi indicazioni stradali nella risposta

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

L'esempio seguente utilizza la Ricerca nelle vicinanze 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 visiti questi link, la recensione o la foto si aprirà in Google Maps.

Ad esempio, la seguente ricerca di testo 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 acquisire familiarità con l'API e le relative opzioni.

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

  2. Se vuoi, 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 di Explorer API, seleziona l'icona di espansione Espandi Explorer API. per espandere la finestra di Explorer API.