Les tuiles de carte sont simplement la division du monde en un bloc indexé
la grille. Il vous permet 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 à
de plusieurs ensembles de données géographiques thématiques, y compris ceux sélectionnés par Google:
Tuiles d'image de feuille de route basées sur des données topographiques vectorielles avec et un style cartographique.
Les orthophotographies sont réalisées à la fois par des appareils photo satellite et aéronautiques qui permettent une imagerie descendante de la Terre (nadir).
Cartes arrondies de l'ombrage
Les tuiles de carte 2D sont toutes géo-référencées et alignées les unes par rapport aux autres. Ils sont sélectionnés en fonction de l'étendue géographique de la fenêtre d'affichage et du niveau de zoom. Niveaux de zoom vont de zéro (pour voir le monde dans son intégralité) à 22 (pour voir les rues et 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 politiques |
Satellite | Images prises depuis l'espace |
Relief | Une carte en contours qui montre des éléments géographiques naturels tels que la végétation |
Pour demander des tuiles de carte à partir de 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 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
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. Fenêtre d'affichage les requêtes d'information 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 d'é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 de l'océan puisque il finirait simplement par afficher des carrés bleus sans fonctionnalité.
La requête de fenêtre d'affichage 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 au nord, au sud, à l'est et à l'ouest de la fenêtre d'affichage, exprimé en degrés. Le nord et le sud doivent être compris dans la plage (-90,90), et l'est et l'ouest doivent se trouver dans la plage (-180, 180). Pour exprimer les limites qui traversent l'antiméridien, l'ouest peut être une valeur positive (par exemple, 170) et l'est peut être négative (par exemple, -170). Tout sont obligatoires.
Réponses aux requêtes d'informations sur la fenêtre d'affichage
La réponse de la fenêtre d'affichage indique quelles zones contiennent des images, et à quel niveau de zoom et des niveaux de service. Une réponse d'information de fenêtre d'affichage 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 afficher les tuiles de feuille de route et de satellite. Pour en savoir plus, consultez les Règles de l'API Map Tiles
maxZoomRect
- Contient un tableau de rectangles de délimitation qui chevauchent le rectangle actuel fenêtre d'affichage. 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 aux coordonnées de tuile à un niveau de zoom spécifique.
Prenons l'exemple de code JavaScript suivant, qui effectue d'abord une conversion à partir d'un
latLng
à un point, puis d'un point à une 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
};
}