Tuiles de carte

Présentation des tuiles de la feuille de routeLes tuiles de feuille de route sont des tuiles d'image basées sur des données topographiques vectorielles au style cartographique de Google. y compris les routes, les bâtiments, les points d'intérêt et les limites politiques.

Obtention des vignettes de la feuille de route...

Vous pouvez commencer à envoyer des requêtes de tuiles de feuille de route après avoir 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 dans vos requêtes de tuiles.

L'exemple de code suivant illustre une requête de jeton de session type pour les tuiles de la 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"

Pour obtenir les tuiles de feuille de route, effectuez 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 GET HTTPS, z est le niveau de zoom (compris entre 0 et 22), et x et y sont les coordonnées de tuile 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 tuile dans le sens inverse des aiguilles d'une montre. orientation est compatible avec les tuiles roadmap, ainsi que pour les requêtes satellite et terrestres où les images de base sont supprimées à l'aide de "overlay": true et avec layerTypes défini. Les valeurs orientation valides sont 0 (valeur 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 correspond ici du nord au sud sur la carte.

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

Exemple de requête de vignette

Prenons l'exemple suivant, qui demande une seule carte 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. Au lieu de cela, la carte est téléchargée dans un fichier local contenant les statistiques suivantes.

Le monde entier dans une seule tuile

  % 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 plus d'informations sur les en-têtes de message de réponse, consultez la section Prélecture, mise en cache ou stockage du contenu.