Les Map Tiles sont simplement la division du monde en une grille indexée
grid. Elles vous permettent d'accéder aux données cartographiques et de les utiliser de manière efficace et dynamique
à plusieurs échelles cartographiques. L'API Map Tiles vous donne accès à
plusieurs géodatasets thématiques, y compris ceux organisés par Google :
Tuiles d'images de cartes routières basées sur des données topographiques vectorielles avec le style cartographique de Google.
Orthophotographie capturée par des caméras satellite et aéroportées qui fournissent des images de la Terre vues de dessus (nadir).
Cartes de courbes de niveau ombrées.
Les 2D Map Tiles sont toutes géoréférencées et alignées les unes sur les autres. Elles sont sélectionnées en fonction de l'étendue géographique de la fenêtre d'affichage et du niveau de zoom. Les niveaux de zoom vont de zéro (pour afficher le monde entier) à 22 (pour afficher les rues et les pâtés de maisons).
Thèmes de carte
Vous pouvez obtenir des tuiles de carte pour les thèmes suivants.
| Thème de carte | Description |
|---|---|
| Carte routière | Routes, bâtiments, points d'intérêt et limites politiques |
| Satellite | Images photographiques prises depuis l'espace |
| Relief | Carte de courbes de niveau qui montre des éléments naturels tels que la végétation |
Pour demander des tuiles de carte à l'API Map Tiles, vous devez d'abord demander un
jeton de session. Le jeton de session suit l'état actuel de votre carte et de votre fenêtre d'affichage. Lorsque vous configurez votre jeton de session, vous devez définir la valeur mapType pour qu'elle corresponde au thème de carte souhaité.
Vous devez ensuite inclure le jeton de session dans chacune de vos requêtes adressées à l'API Map Tiles.
Requêtes d'informations sur la fenêtre d'affichage
La fenêtre d'affichage définit la taille de la zone qui encadre la scène du monde. Les requêtes d'informations sur la fenêtre d'affichage renvoient des détails sur les tuiles de carte qui composent votre fenêtre d'affichage actuelle. Vous demandez des informations sur la fenêtre d'affichage pour éviter de demander des images à des niveaux de zoom qui n'existent pas.
Par exemple, la plupart des villes disposent d'images au niveau de zoom 22, mais pas l'océan, car il n'afficherait que des carrés bleus sans caractéristiques.
La requête de fenêtre d'affichage est une requête HTTPS GET au format suivant.
curl "https://tile.googleapis.com/tile/v1/viewport?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &zoom=zoom &north=north &south=south &east=east &west=west"
La requête contient les champs suivants :
zoom- Niveau de zoom de la fenêtre d'affichage.
north,south,east,west- Points les plus au nord, au sud, à l'est et à l'ouest de la fenêtre d'affichage, exprimés en degrés. Le nord et le sud doivent être compris entre -90 et 90, et l'est et l'ouest entre -180 et 180. Pour exprimer des limites qui traversent l'antiméridien, l'ouest peut être positif (par exemple, 170) et l'est négatif (par exemple, -170). Tous les paramètres sont obligatoires.
Réponses d'informations sur la fenêtre d'affichage
La réponse de la fenêtre d'affichage vous indique les zones qui comportent des images et les niveaux de zoom correspondants. Une réponse d'informations sur la fenêtre d'affichage se présente comme suit.
{
"copyright": "Map data ©2023",
"maxZoomRects": [
{
"maxZoom": 19,
"north": 90,
"south": -90,
"east": 180,
"west": -180
},
{
"maxZoom": 9,
"north": 90,
"south": -90,
"east": 180,
"west": -180
},
{
"maxZoom": 14,
"north": 84.375,
"south": -84.375,
"east": 180,
"west": -180
}, ...
]
}
Le corps de la réponse contient les champs suivants.
copyright- Contient une chaîne d'attribution que vous devez afficher sur votre carte lorsque vous affichez des tuiles de carte routière et satellite. Pour en savoir plus, consultez les Règles de l'API Map Tiles.
maxZoomRect- Contient un tableau de rectangles englobants qui se chevauchent avec la fenêtre d'affichage actuelle. Contient également le niveau de zoom maximal disponible dans chaque rectangle.
Fonctions de coordonnées de tuile
Des outils (fonctions simples) sont disponibles dans la plupart des langages de programmation pour convertir des paires latitude/longitude en coordonnées de tuile à un niveau de zoom spécifique.
Considérez l'exemple de code JavaScript suivant, qui convertit d'abord un latLng en point, puis un point en coordonnées de tuile.
var TILE_SIZE = 256;
function fromLatLngToPoint(latLng) {
var mercator = -Math.log(Math.tan((0.25 + latLng.lat() / 360) * Math.PI));
return {
x: TILE_SIZE * (latLng.lng() / 360 + 0.5),
y: TILE_SIZE / 2 * (1 + mercator / Math.PI)
};
}
function fromLatLngToTileCoord(latLng, zoom) {
var point = fromLatLngToPoint(latLng);
var scale = Math.pow(2, zoom);
return {
x: Math.floor(point.x * scale / TILE_SIZE),
y: Math.floor(point.y * scale / TILE_SIZE),
z: zoom
};
}