Blocs de relief

Les vignettes de terrain sont des vignettes d'image qui contiennent une cartographie des ombres portées et des courbes de niveau. Elles incluent des éléments naturels tels que la végétation.

Obtenir des vignettes de terrain

Vous pouvez commencer à envoyer des requêtes de vignettes de terrain après avoir obtenu un jeton de session. Étant donné qu'un jeton de session s'applique à l'ensemble de la session, vous n'avez pas à spécifier les options de carte avec vos requêtes de vignettes.

L'exemple de code suivant illustre une requête de jeton de session typique pour les vignettes de terrain.

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

Vous obtenez des vignettes de terrain en envoyant une requête HTTPS GET, comme illustré dans l'exemple suivant.

curl "https://tile.googleapis.com/v1/2dtiles/z/x/y?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY"

Exemple de requête de vignette

Prenons l'exemple suivant, qui demande une seule vignette de terrain avec un niveau de zoom de 10 et des coordonnées x et y de (192, 401).

curl "https://tile.googleapis.com/v1/2dtiles/10/192/401?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY" --output /tmp/example_tile.png

Dans cet exemple, le serveur n'envoie aucun message de réponse. La vignette est simplement téléchargée dans un fichier local.

Pour en savoir plus sur les en-têtes des messages de réponse, consultez Pré-récupération, mise en cache ou stockage de contenu.