Tuiles de carte

Les tuiles de feuille de route sont des tuiles d'images 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 tuiles de feuille de route

Vous pouvez commencer à envoyer des requêtes de tuiles de carte routière après avoir obtenu un jeton de session. Comme le jeton de session s'applique à l'ensemble de la session, vous n'avez pas besoin de spécifier les options de carte dans vos requêtes de tuiles.

L'exemple de code suivant illustre une requête de jeton de session standard pour des tuiles de carte routière.

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"

Pour obtenir des tuiles de carte routière, envoyez 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&orientation=0_or_90_or_180_or_270"

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

Le paramètre orientation est facultatif. Sa valeur spécifie 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 de satellite et de relief dont l'imagerie de base a été supprimée à l'aide de "overlay": true et avec layerTypes 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 gauche à droite de la tuile, 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 0, et les coordonnées x et y sont 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, il n'y a pas de message de réponse du serveur. À la place, 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.