Utilizzare i token di sessione con l'API Map Tiles

Un token di sessione è un dato (un UUID) che viene utilizzato nelle chiamate REST per identificare sessione: una di scambi di messaggi correlati. Devi includere un token di sessione in tutte le richieste di riquadri 2D e immagini di Street View. Lo includi come valore di un parametro session aggiunto a tutte le richieste URL.

Nell'API Map Tiles, un token di sessione rappresenta un insieme definito di opzioni di visualizzazione. Ciò significa che non devi passare una serie di opzioni di visualizzazione con per ogni richiesta di riquadro. Puoi utilizzare lo stesso token di sessione su più client. Un token di sessione è attualmente valido per due settimane dal suo ma la situazione potrebbe cambiare. Puoi sempre controllare la data e l'ora di scadenza di un token di sessione controllando il campo expiry nel messaggio di risposta.

Richiesta di token di sessione

Per richiedere un token di sessione, invia una richiesta POST HTTPS all'endpoint createSession, come mostrato nell'esempio seguente. Devi inviare la richiesta con un Intestazione Content-Type: application/json.

curl -X POST -d '{
  "mapType": "streetview",
  "language": "en-US",
  "region": "US"
}' \
-H 'Content-Type: application/json' \
"https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY"

Campi obbligatori

mapType

Il tipo di mappa base. Questo valore può essere uno dei seguenti:

roadmap
I riquadri di mappe dipinte standard di Google Maps.
satellite
Immagini satellitari.
terrain
Immagini del terreno. Quando selezioni terrain come tipo di mappa, devi anche includono il tipo di livello layerRoadmap (descritto nel Campi facoltativi ).
streetview
Panoramidi Street View. Per ulteriori informazioni, vedi Riquadri di Street View.
language

Un Tag lingua IETF che specifica la lingua utilizzata per visualizzare le informazioni nei riquadri. Per Ad esempio, en-US specifica la lingua inglese parlata negli Stati Uniti.

region

R Repository di dati delle impostazioni internazionali comune identificatore di regione (due lettere maiuscole) che rappresenta la località fisica dell'utente. Ad esempio, US.

Campi facoltativi

imageFormat
Specifica il formato del file da restituire. I valori validi sono jpeg o png. I file JPEG non supportano la trasparenza, pertanto non sono consigliati per riquadri sovrapposti. Se non specifichi un imageFormat, il formato migliore per il riquadro viene scelto automaticamente.
scale

Ridimensiona le dimensioni degli elementi della mappa (come le etichette delle strade), mantenendo il valore dimensioni del riquadro e area di copertura del riquadro predefinito. Aumentando la scala anche riduce il numero di etichette sulla mappa e di conseguenza si riduce il disordine. I seguenti valori sono valori scale validi:

  • scaleFactor1x: il valore predefinito.
  • scaleFactor2x: raddoppia le dimensioni delle etichette e rimuove le etichette delle caratteristiche minori.
  • scaleFactor4x: quadruplica le dimensioni delle etichette e rimuove le etichette delle caratteristiche minori.

I seguenti esempi mostrano l'effetto del ridimensionamento degli elementi della mappa.

Fattore di scala 1x Fattore di scala 2x
Mappa che mostra il fattore di scala 1x Mappa che mostra il fattore di scala 2x
highDpi
Specifica se restituire riquadri ad alta risoluzione. Se il fattore di scala è aumentato, highDpi viene utilizzato per aumentare le dimensioni del riquadro. Generalmente, aumentando il fattore di scala ingrandisce il riquadro risultante in un'immagine del di tutte le dimensioni, con conseguente riduzione della qualità. Con highDpi, anche le dimensioni risultanti sono aumentati, preservando la qualità. DPI è l'acronimo di Dots per Inch, mentre High DPI indica il riquadro viene visualizzato usando più punti per pollice del normale. Se true, il numero di pixel in ciascuna delle dimensioni x e y viene moltiplicato per il coefficiente di scala (ovvero 2x o 4x). L'area di copertura del riquadro rimane invariata. Questo parametro funziona solo con i valori scale pari a 2x o 4x. Non ha alcun effetto su 1 riquadro bilancia.
Fattore di scala 1x Fattore di scala 2x alto DPI
Mappa visualizzata a risoluzione normale Mappa visualizzata con risoluzione 2x High DPI
layerTypes

Un array di valori che specifica i tipi di livello aggiunti alla mappa. Valido sono:

layerRoadmap
Obbligatorio se specifichi terrain come tipo di mappa. Può essere anche facoltativamente sovrapposto al tipo di mappa satellite. Non ha effetto sui riquadri della roadmap.
layerStreetview
Mostra le strade e le località con Street View tramite contorni blu sulla mappa.
layerTraffic
Mostra le condizioni attuali del traffico.
styles

Un array di oggetti JSON di stile che specificano l'aspetto e il livello di dettaglio degli elementi della mappa, come strade, parchi e aree urbanizzate. La personalizzazione viene utilizzata per personalizzare la mappa base standard di Google. Il parametro styles è valido solo se il tipo di mappa è roadmap. Per la sintassi completa dello stile, consulta Riferimento di stile.

overlay

Un valore booleano che specifica se layerTypes deve essere visualizzato come overlay separato o combinato con le immagini di base. Quando true, la mappa base non viene visualizzata. Se non hai definito alcun valore layerTypes, questo valore viene ignorato.

Ad esempio, la richiesta di un tipo di mappa satellite con un livello layerRoadmap e overlay impostato su false restituisce riquadri equivalenti al tipo di mappa hybrid utilizzata nell'API Maps JavaScript (immagine a sinistra). Uguale I tipi di mappa e livelli con l'opzione overlay impostata su true mostrano un riquadro trasparente con una sovrapposizione sulla mappa, con stili adeguati per la sovrapposizione sulle immagini satellitari (immagine a destra).

overlay: falso overlay: vero
Overlay impostato su false Overlay impostato su true

Il seguente JSON è un esempio di corpo di una richiesta tipica che contiene sia campi obbligatori e facoltativi.

{
  "mapType": "satellite",
  "language": "en-US",
  "region": "us",
  "layerTypes": [ "layerRoadmap", "layerStreetview" ],
  "overlay":  true,
  "scale": "scaleFactor1x",
  "styles": [
    {
      "stylers": [
        { "hue": "#00ffe6" },
        { "saturation": -20 }
      ]
    },{
      "featureType": "road",
      "elementType": "geometry",
      "stylers": [
        { "lightness": 100 },
        { "visibility": "simplified" }
      ]
    }
  ]
}

Questo esempio fornisce un overlay adatto all'uso combinato con il satellite immagini. L'esempio contiene sia una mappa stradale che un overlay di Street View. La la mappa risultante viene visualizzata con nomi e dati in lingua inglese, parlata negli Stati Uniti.

apiOptions: un array di valori che specifica opzioni aggiuntive da applicare. Le opzioni supportate sono:

  • MCYJ5E517XR2JC - Attiva nuova mappa stile. Durante il periodo di attivazione, le tue richieste riceveranno i dati a meno che non venga specificato questo valore.

Risposta del token di sessione

Il codice JSON seguente è un esempio di corpo della risposta.

{
  "session": "IgAAAHGU9jnAU4KOAfwY3Bcd6eH_WxQsyocSBAdUnAr9pnvTTNXtF9c_27RBo94ytEXTDg",
  "expiry": "1361828036",
  "tileWidth": 256,
  "tileHeight": 256,
  "imageFormat": "png"
}

Il seguente elenco contiene le definizioni dei campi nel corpo della risposta.

session
Un valore del token di sessione da includere in tutte le richieste dell'API Map Tiles.
expiry
Una stringa contenente la data e l'ora (in secondi dall'epoca) di scadenza del token. Un token di sessione è valido per due settimane dalla sua creazione in un arco di tempo, ma queste norme potrebbero cambiare senza preavviso.
tileWidth
La larghezza dei riquadri misurata in pixel.
tileHeight
L'altezza dei riquadri misurata in pixel.
imageFormat
Il formato dell'immagine, che può essere png o jpeg.