Riquadri della roadmap

Sviluppatori dello Spazio economico europeo (SEE)

Panoramica del riquadro RoadmapI riquadri della roadmap sono riquadri immagine basati su dati topografici vettoriali con lo stile cartografico di Google. Sono inclusi strade, edifici, punti di interesse e confini politici.

Ottenere i riquadri della roadmap

Puoi iniziare a effettuare richieste di riquadri della roadmap dopo aver ricevuto un token di sessione. Poiché il token di sessione si applica all'intera sessione, non devi 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 roadmap.

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"

Per ottenere i riquadri della roadmap, effettua 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) e x e y sono le coordinate 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 di rilievi con le immagini di base rimosse utilizzando "overlay": true e con layerTypes impostato. I valori orientation validi sono 0 (il valore 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 del riquadro da sinistra a destra, che in questo caso va da nord a sud sulla mappa.

Orientamento a zero gradi Orientamento a 90 gradi
Orientamento a zero gradi Orientamento a 90 gradi

Esempio di richiesta di riquadro

Considera il seguente esempio, che richiede un singolo riquadro contenente il mondo intero. 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.

Il mondo intero in una sola scheda

  % 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 Pre-fetching, memorizzazione nella cache o archiviazione dei contenuti.