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 importanti.

La risposta di Ricerca testuale (New), Ricerca nelle vicinanze (New) e Dettagli luogo (New) può contenere anche link a Google Maps. Gli utenti possono sfogliare questi link di Google Maps per visualizzare ulteriori informazioni su un luogo nella risposta.

Ad esempio, cerchi gli aeroporti di San Francisco, California. La risposta include 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 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 a Maps alla recensione in modo da poterla visualizzare in un browser.

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

L'API Explorer 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 di Google Maps che puoi includere nella risposta:

Includi tutti i link nella risposta di Places

I link nella risposta di Places sono contenuti nel googleMapsLinks campo. Assicurati di includere il campo googleMapsLinks nella maschera dei campi della richiesta se vuoi che vengano visualizzati nella risposta.

Ad esempio, la seguente Ricerca testuale (New) 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"
      }
    }
  ]
}

Includi 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 dei campi 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 attuale viene utilizzata come origine, la posizione del luogo viene utilizzata come destinazione e la modalità di viaggio è in auto.

L'esempio successivo utilizza Ricerca nelle vicinanze (New) 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 i link a recensioni e foto

Questa release aggiunge il googleMapsUri campo agli Reviews e Photos oggetti nella risposta. Se sfogli questi link, la recensione o la foto si aprono in Google Maps.

Ad esempio, la seguente Ricerca testuale (New) 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.

Fai una prova!

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

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

2. Se vuoi, espandi Mostra parametri standard e imposta il fields parametro sulla maschera dei campi.

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 API Explorer, seleziona fullscreen

   Schermo intero per espandere la finestra API Explorer.