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. 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. 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, il campo googleMapsUri viene aggiunto anche 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.

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

Prova!

Link di Google Maps supportati per un luogo

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

Includi tutti i link nella risposta di Places

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

Includere un link specifico nella risposta

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, 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

Includi link a recensioni e foto

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

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

1. Seleziona l'icona dell'API 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 fullscreen .

   A schermo intero per espandere la finestra di Explorer API.