Les tuiles de carte correspondent simplement à la division du monde en une grille indexée. Il vous permet d'accéder aux données cartographiques de manière efficace et dynamique à plusieurs échelles cartographiques. L'API Map Tiles vous donne accès à plusieurs ensembles de données géographiques thématiques, y compris les suivants, sélectionnés par Google:
Tuiles d'images de la feuille de route basées sur des données topographiques vectorielles avec le style cartographique de Google.
Orthophotographie capturée par des caméras satellitaires et aériennes qui fournissent des images de la Terre de haut en bas (nadir).
Cartes de courbes de niveau en ombre portée.
Les tuiles de carte 2D 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 dans son intégralité) à 22 (pour afficher les rues et les blocs).
Thèmes de carte
Vous pouvez obtenir des tuiles de carte pour les thèmes de carte suivants.
| Thème de la carte | Description |
|---|---|
| Feuille de route | Routes, bâtiments, points d'intérêt et limites administratives |
| Satellite | Images photographiques prises depuis l'espace |
| Relief | Carte topographique qui montre les é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 à l'API Map Tiles.
Demandes 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 informations sur les tuiles de carte qui composent votre fenêtre d'affichage actuelle. Vous demandez des informations sur le viewport 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 détails.
La requête de vue d'ensemble est une requête GET HTTPS 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 éloignés vers le nord, le sud, l'est et l'ouest dans le viewport, exprimés en degrés. Le nord et le sud doivent être compris dans la plage (-90,90), et l'est et l'ouest dans la plage (-180, 180). Pour exprimer des limites qui croisent l'antiméridien, l'ouest peut être positif (par exemple, 170) et l'est peut être négatif (par exemple, -170). Tous les paramètres sont obligatoires.
Réponses aux informations sur la fenêtre d'affichage
La réponse de la fenêtre d'affichage indique les zones qui comportent des images et les niveaux de zoom. Une réponse d'informations sur le viewport se présente sous la forme suivante.
{
"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 cartes routières et des tuiles satellite. Pour en savoir plus, consultez les Règles de l'API Map Tiles.
maxZoomRect- Contient un tableau de rectangles de délimitation qui se chevauchent avec le viewport actuel. Inclut é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 de 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
};
}