Les cartes de feuille de route sont des cartes d'images basées sur des données topographiques vectorielles
avec le style cartographique de Google. Elles incluent les routes, les bâtiments, les points
d'intérêt et les limites politiques.
Obtenir des cartes de feuille de route
Vous pouvez commencer à envoyer des requêtes de cartes 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 avec vos requêtes de cartes.
L'exemple de code suivant illustre une requête de jeton de session typique pour les cartes 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 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 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 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 cartes 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 pour lesquelles layerTypes est défini. Les valeurs orientation valides sont 0 (par défaut), 90, 180 et 270.
La grille de coordonnées de la carte 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 carte, 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 carte
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, le serveur n'envoie aucun message de réponse. 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 des messages de réponse, consultez Pré-récupération, mise en cache ou stockage de contenu.