Présentation des cartes 2D

Exemple de feuille de routeLes tuiles de carte sont simplement la division du monde en un bloc indexé la grille. Il 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 à plusieurs ensembles de données géographiques thématiques, y compris les suivants, 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.

  • 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éo-référencées et alignées les unes par rapport aux autres. Elles sont sélectionnées 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). Tous les paramètres 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 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. 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 de latitude/longitude en 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
  };
}