I riquadri della mappa stradale sono riquadri di immagini basati su dati topografici vettoriali con lo stile cartografico di Google. Sono incluse strade, edifici, punti di interesse e confini politici.
Recupero dei riquadri della mappa stradale in corso…
Puoi iniziare a effettuare richieste di riquadri della mappa stradale dopo aver ottenuto un token di sessione. Poiché il token di sessione si applica all'intera sessione, non è necessario specificare le opzioni della mappa con le richieste di riquadri.
Il seguente esempio di codice mostra una tipica richiesta di token di sessione per i riquadri della mappa stradale.
curl -X POST -d '{ "mapType": "roadmap", "language": "en-US", "region": "US" }' \ -H 'Content-Type: application/json' \ "https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY"
Puoi ottenere i riquadri della mappa stradale effettuando una richiesta GET HTTPS, come mostrato nell'esempio seguente.
curl "https://tile.googleapis.com/v1/2dtiles/z/x/y?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &orientation=0_or_90_or_180_or_270"
In questa richiesta GET HTTPS, z è il livello di zoom (da 0 a 22), mentre x e y sono le coordinate dei riquadri del riquadro che vuoi recuperare.
Il parametro orientation è facoltativo. Il suo valore specifica il numero di gradi di rotazione in senso antiorario dell'immagine del riquadro. orientation è supportato per i riquadri roadmap, nonché per le richieste di immagini satellitari e del terreno con le immagini di base rimosse utilizzando "overlay": true e con layerTypes impostato. I valori orientation validi sono 0 (predefinito), 90, 180 e
270.
La griglia delle coordinate dei riquadri non viene ruotata se includi un valore orientation. Ad esempio, se imposti orientation su 90, la coordinata x definisce comunque la posizione da sinistra a destra del riquadro, che in questo caso va da nord a sud sulla mappa.
| Orientamento a zero gradi | Orientamento a 90 gradi |
|---|---|
 |
 |
Esempio di richiesta di un riquadro
Considera l'esempio seguente, che richiede un singolo riquadro contenente l'intero mondo. In questo esempio, il livello di zoom è 0 e le coordinate x e y sono 0, 0.
curl "https://tile.googleapis.com/v1/2dtiles/0/0/0?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY" --output /tmp/example_tile.png
In questo esempio non è presente alcun messaggio di risposta dal server. Il riquadro viene invece scaricato in un file locale, con le seguenti statistiche.
% Total % Received % Xferd Average Speed Time Time Time Current Dload Upload Total Spent Left Speed 100 8335 100 8335 0 0 51471 0 --:--:-- --:--:-- --:--:-- 54835
Per informazioni sulle intestazioni dei messaggi di risposta, consulta Precaricamento, memorizzazione nella cache o archiviazione dei contenuti.