Tuiles de carte

Les tuiles de feuille de route sont des tuiles d'image basées sur des données topographiques vectorielles avec le style cartographique de Google. Cela inclut les routes, les bâtiments, les points d'intérêt et les limites politiques.

Obtenir des vignettes de feuille de route

Vous pouvez commencer à envoyer des demandes de vignettes de feuille de route une fois que vous avez obtenu un jeton de session. Étant donné que le jeton de session s'applique à l'ensemble de la session, vous n'avez pas besoin de spécifier les options de carte avec vos requêtes de tuiles.

L'exemple de code suivant illustre une requête de jeton de session typique pour les tuiles de feuille de route.

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"

Vous obtenez des tuiles de feuille de route en envoyant une requête HTTPS GET, comme indiqué dans l'exemple suivant.

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"

Dans cette requête HTTPS GET, z correspond au niveau de zoom (de 0 à 22), et x et y correspondent aux coordonnées de la tuile que vous souhaitez récupérer.

Le paramètre orientation est facultatif. Sa valeur indique le nombre de degrés de rotation de l'image de la tuile dans le sens inverse des aiguilles d'une montre. orientation est compatible avec les tuiles roadmap, ainsi qu'avec les requêtes satellite et de terrain dont l'imagerie de base a été supprimée à l'aide de "overlay": true et dont layerTypes est défini. Les valeurs orientation valides sont 0 (par défaut), 90, 180 et 270.

La grille de coordonnées des tuiles n'est pas pivotée si vous incluez une valeur orientation. Par exemple, si vous définissez orientation sur 90, la coordonnée x définit toujours la position de la tuile de gauche à droite, qui dans ce cas va du nord au sud sur la carte.

Orientation à zéro degré	Orientation à 90 degrés

Exemple de requête de tuile

Prenons l'exemple suivant, qui demande une seule tuile contenant le monde entier. Dans cet exemple, le niveau de zoom est défini sur 0, et les coordonnées x et y sont définies sur 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

Dans cet exemple, le serveur n'envoie aucun message de réponse. Au lieu de cela, la tuile est téléchargée dans un fichier local, avec les statistiques suivantes.

  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  8335  100  8335    0     0  51471      0 --:--:-- --:--:-- --:--:-- 54835

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