ForHosting KIT · Voyages et géographie

Résolution au sol Web Mercator

À l'équateur et au zoom 0, un pixel d'une carte web standard couvre 156 543,033928 m et une tuile complète de 256 pixels, 40 075 016,6856 m. Chaque niveau de zoom divise cette valeur par deux, et les régions proches des pôles la réduisent encore. Gratuit dans votre navigateur.

Gratuit
Fonctionne dans votre navigateur
Sans inscription
Vos données restent sur votre appareil

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Exemple résolu

Si vous saisissez

Latitude: 0
Niveau de zoom: 0

Vous obtenez

Mètres par pixel: 156 543,033928
Mètres par tuile: 40 075 016,6856
Taille de tuile (px): 256
Rayon terrestre (m): 6 378 137

Il emploie la sphère EPSG:3857, des tuiles de 256 pixels et la pyramide XYZ habituelle. Le résultat vous aide à convertir des distances à l’écran, dimensionner des symboles, créer une échelle ou choisir des images au bon niveau de détail. Le calcul est déterministe, sans accès réseau, et renvoie aussi la largeur au sol d’une tuile complète.

Comprenez ce que mesure la résolution au sol

La résolution au sol exprime la distance réelle approximative couverte par un pixel de carte, généralement en mètres par pixel. Elle ne correspond ni à la résolution d’un écran, ni à la précision GPS, ni au détail natif d’une photographie aérienne. Elle relie la grille numérique Web Mercator à une distance terrestre pour une latitude précise.

Au zoom zéro, le monde projeté tient dans une tuile de 256 pixels. Chaque niveau supplémentaire double le nombre de tuiles dans chaque direction et divise par deux la distance par pixel. La latitude compte, car Web Mercator agrandit l’échelle près des pôles.

À zoom égal, un pixel couvre donc moins de terrain est-ouest loin de l’équateur.

Fonctionnement de la formule Web Mercator

Le calculateur emploie le rayon équatorial de 6,378,137 mètres adopté par EPSG:3857. Il calcule d’abord la circonférence sphérique, soit deux fois pi fois ce rayon. Sa division par 256 fournit la résolution initiale à l’équateur au zoom zéro.

La réponse suppose une tuile logique standard de 256 pixels. Si votre moteur sert des images de 512 pixels, vérifiez ses conventions de tuile et de zoom. Seuls les zooms entiers de zéro à trente et les latitudes comprises dans la limite pratique Web Mercator, environ ±85.05112878 degrés, sont acceptés.

Ce contrôle empêche qu’une position hors du monde fini de la carte soit présentée comme valable.

Exploitez le résultat sans surestimer sa précision

Considérez la résolution comme une conversion d’échelle, pas comme une garantie de précision des données. Deux mètres par pixel signifient qu’une ligne de dix pixels couvre environ vingt mètres près de cette latitude, mais la route, l’image ou la position peuvent être bien moins précises. L’échelle varie aussi dans une vue avec la latitude ; le centre convient généralement à une carte interactive, tandis qu’une grande exportation régionale peut demander plusieurs échantillons.

Cette valeur sert à choisir un rayon de regroupement, convertir une tolérance de clic, estimer l’emprise d’un raster et légender une barre d’échelle. Chaque niveau entier divise les mètres par pixel par deux.

Cas d’usage

Créer une barre d’échelle fiable

Convertissez une largeur en pixels à la latitude centrale en distance approximative à afficher.

Préparer des exports raster

Estimez la largeur au sol des tuiles ou pixels avant de demander ou traiter des images cartographiques.

Questions fréquentes

Pourquoi la résolution varie-t-elle avec la latitude ?

Web Mercator agrandit l’échelle vers les pôles ; un pixel projeté couvre donc moins de terrain aux hautes latitudes.

Quelle taille de tuile est supposée ?

Le calcul suppose la taille logique conventionnelle de 256 pixels pour une tuile de carte glissante.

Puis-je fournir un zoom fractionnaire ?

Non. Cette capacité accepte les niveaux entiers de la pyramide de tuiles, de 0 à 30.

Comment convertir une distance à l'écran en mètres sur le terrain ?

Multipliez les mètres par pixel par la largeur en pixels mesurée sur la carte. La valeur reste valable près de la latitude indiquée : recalculez-la si vous vous déplacez loin vers le nord ou le sud.

Pourquoi la latitude est-elle limitée à 85,05112878 degrés ?

Parce que c'est la limite pratique du Web Mercator, qui étire la carte de plus en plus près des pôles. Les valeurs au-delà sont refusées pour qu'un nombre plausible ne passe pas pour une position valable sur la carte.

Outils associés

Pour les développeurs — accès API

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

Endpoint

POSThttps://api.kit.forhosting.com/geo/web-mercator-ground-resolution

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

Appeler depuis votre stack

curl -X POST https://api.kit.forhosting.com/geo/web-mercator-ground-resolution \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"latitude":40.7128,"zoom":12}'

const res = await fetch("https://api.kit.forhosting.com/geo/web-mercator-ground-resolution", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "latitude": 40.7128,
    "zoom": 12
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/geo/web-mercator-ground-resolution",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "latitude": 40.7128,
    "zoom": 12
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/web-mercator-ground-resolution", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"latitude":40.7128,"zoom":12}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"latitude":40.7128,"zoom":12}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/web-mercator-ground-resolution", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemple de requête

{
  "latitude": 40.7128,
  "zoom": 12
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.web_mercator_ground_resolution",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

Tarifs

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.

Notes techniques

Ce calculateur de résolution au sol Web Mercator indique combien de mètres réels représente un pixel à une latitude et un niveau de zoom donnés.

Comprenez ce que mesure la résolution au sol

Utilisez meters_per_pixel près de la latitude fournie, puis multipliez-le par une largeur en pixels. meters_per_tile applique la même résolution à une tuile XYZ entière.

Fonctionnement de la formule Web Mercator

Il divise ensuite par deux élevé au zoom et multiplie par le cosinus de la latitude en radians. En bref, la résolution vaut cos(latitude) fois 2πR, divisé par 256 fois 2^zoom.

Exploitez le résultat sans surestimer sa précision

À zoom égal, une latitude absolue supérieure donne une valeur inférieure à cause du cosinus. L’API coûte $0.002 par élément réussi et exécute le même calcul déterministe que le navigateur.

Cas d'intégration

Choisir les rayons de regroupement et de clic

Transformez des seuils d’interface en pixels en mètres pour un zoom et une latitude.

Questions techniques

Quelle formule ce calculateur utilise-t-il ?

Il utilise cos(latitude) × 2π × 6378137 divisé par 256 × 2^zoom, après conversion de la latitude en radians.

Combien coûte une requête API ?

Chaque élément traité avec succès coûte $0.002. Une entrée incorrecte renvoie l’erreur invalid_input.

Consulter la documentation complète du KIT →

Lancer gratuitement

Exemple résolu

Comprenez ce que mesure la résolution au sol

Fonctionnement de la formule Web Mercator

Exploitez le résultat sans surestimer sa précision

Cas d’usage

Créer une barre d’échelle fiable

Préparer des exports raster

Questions fréquentes

Outils associés

Pour les développeurs — accès API

Endpoint

Appeler depuis votre stack

Exemple de requête

Exemple de réponse

Tarifs

Erreurs

Notes techniques

Comprenez ce que mesure la résolution au sol

Fonctionnement de la formule Web Mercator

Exploitez le résultat sans surestimer sa précision

Cas d'intégration

Choisir les rayons de regroupement et de clic

Questions techniques

merci