Les tuiles de la 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 administratives.
Obtenir des cartes de la feuille de route
Vous pouvez commencer à envoyer des requêtes de cartes 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 tuile.
L'exemple de code suivant illustre une requête de jeton de session typique pour les cartes de la 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 cartes de la feuille de route, envoyez une requête GET HTTPS, 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 correspond au niveau de zoom (de 0 à 22), et x et y correspondent aux coordonnées de la carte de la carte 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 carte dans le sens inverse des aiguilles d'une montre. orientation est compatible avec les tuiles roadmap, et également avec les requêtes satellite et terrain dont les images de base ont été supprimées à 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 la carte de gauche à droite, qui, dans ce cas, va du nord au sud sur la carte.
| Orientation à 0 degré | Orientation à 90 degrés |
|---|---|
 |
 |
Exemple de requête de carte
Prenons l'exemple suivant, qui demande une seule carte contenant le monde entier. Dans cet exemple, le niveau de zoom est de 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, aucun message de réponse n'est envoyé par le serveur. Au lieu de cela, la carte 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 de message de réponse, consultez la section Préchargement, mise en cache ou stockage de contenu.