Link a Google Maps

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

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

Ad esempio, cerchi gli aeroporti di San Francisco, in California. La risposta include quindi l'Aeroporto Internazionale di San Francisco (SFO) nell'elenco dei luoghi. L'oggetto Place per SFO nella risposta aggiunge il campo googleMapsUri contenente i link a 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 a Google Maps alla recensione, in modo da poterla visualizzare in un browser.

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

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

Fai una prova!

Link di Google Maps supportati per un luogo

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

Includi tutti i link nella risposta di Places

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

Ad esempio, la seguente Ricerca testuale (nuova) include tutti i link a 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 è 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 le 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 Nearby Search (nuova versione) 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 accedi a questi link, la recensione o la foto si aprono in Google Maps.

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

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

2. Facoltativamente, espandi Mostra parametri standard e imposta il parametro fields sulla maschera di campo.

3. Se vuoi, 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

   Schermo intero per espandere la finestra di Explorer API.