ForHosting KIT · Outils pour développeurs

Index H3 approximatif : coordonnées vers cellule hexagonale

Cet outil d’index hexagonal H3 approximatif attribue une coordonnée de latitude et de longitude à une cellule stable d’une grille hexagonale mondiale à sommet pointu.

● BetaGratuit · dans votre navigateur
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Choisissez une résolution de 0 à 15 pour passer de vastes régions à des cellules toujours plus fines. Le résultat comprend un identifiant lisible, des coordonnées axiales, un centre estimé et une longueur d’arête approximative. Il convient au regroupement, au partitionnement, au cache et aux démonstrations légères où des cellules déterministes comptent davantage qu’une interopérabilité exacte avec le système H3 officiel.

Choisissez une résolution adaptée au regroupement

La résolution détermine l’échelle de la grille. La résolution 0 produit des cellules très étendues, puis chaque niveau supérieur divise par deux l’arête exprimée en unités angulaires. La progression est donc prévisible : des points proches séparés à un niveau peuvent partager une cellule à un niveau plus grossier, tandis qu’une résolution accrue crée des groupes plus détaillés. Commencez par une faible résolution pour résumer l’activité de grandes régions, puis augmentez-la pour un regroupement à l’échelle d’un quartier ou une visualisation dense. La longueur d’arête approximative fournit un repère pratique, mais non une garantie géodésique. La grille reposant sur une projection équirectangulaire simple, les distances est-ouest au sol diminuent vers les pôles, même si la géométrie angulaire reste régulière. Testez des coordonnées représentatives de la zone réellement analysée au lieu de choisir un niveau uniquement selon l’estimation de l’arête. Conservez surtout la résolution avec chaque index : deux cellules de résolutions différentes ne couvrent pas la même emprise.

Comprenez la création de l’index approximatif

L’algorithme place la longitude sur un axe horizontal et la latitude sur un axe vertical, superpose un réseau hexagonal à sommet pointu, convertit le point en coordonnées axiales fractionnaires, puis les arrondit au moyen de coordonnées cubiques. Cet arrondi préserve la relation entre les trois axes d’une grille hexagonale et attribue chaque entrée valide à une seule cellule déterministe. L’identifiant contient le préfixe ah3, la résolution choisie et des codes base-36 signés pour les coordonnées q et r. Une même entrée donne ainsi la même sortie, sans réseau, état enregistré, hasard ni données temporelles. Le centre renvoyé provient de la reconversion de la position axiale arrondie en latitude et longitude ; il facilite l’étiquetage, le débogage et le placement d’un repère représentatif. Soyez vigilant aux limites : une infime variation près d’une arête peut sélectionner une cellule voisine, comme dans tout index spatial. Conservez toute la précision des coordonnées sources si la répétabilité près des frontières est essentielle.

Distinguez cette grille du système H3 officiel

Cette capacité reprend volontairement le mode d’utilisation de H3 sans revendiquer de compatibilité binaire, textuelle, géométrique ou hiérarchique avec ses index. Cette grille analytique compacte répond aux besoins de compartiments spatiaux reproductibles lorsqu’une bibliothèque géospatiale spécialisée n’est pas souhaitée. Elle convient au regroupement de positions d’exemple, au partitionnement de clés de cache, aux comptages sommaires de densité, à l’apprentissage des coordonnées axiales et aux jeux de test stables. Le champ compatible_with_h3 vaut toujours false afin qu’un traitement ultérieur ne confonde pas le résultat avec une adresse H3 officielle. Utilisez la bibliothèque H3 officielle pour échanger des index, parcourir de véritables parents et enfants, obtenir les contours canoniques, gérer les pentagones ou exploiter le modèle terrestre icosaédrique de H3. Cette approximation emploie une latitude et une longitude planes : l’aire au sol se déforme avec la latitude et les cellules ne se raccordent pas de part et d’autre de l’antiméridien. Considérez-la comme un système de regroupement déterministe, et non comme une analyse géodésique.

Regrouper des événements cartographiques

Attribuez les coordonnées reçues à des groupes spatiaux stables avant de compter ou résumer les événements.

Créer des clés de cache géographiques

Intégrez la chaîne déterministe de cellule à une clé de cache pour des résultats fondés approximativement sur la position.

Prototyper une carte hexagonale

Explorez les résolutions et coordonnées axiales avant d’adopter une bibliothèque géospatiale complète.

La cellule renvoyée est-elle un index H3 valide ?

Non. Il s’agit d’un identifiant approximatif défini indépendamment et explicitement signalé comme incompatible avec H3.

Que représente la résolution ?

Elle règle le niveau de détail de 0 à 15. Chaque hausse divise l’arête angulaire par deux et affine les groupes spatiaux.

Pourquoi la taille au sol varie-t-elle ?

Le calcul utilise un plan équirectangulaire ; une même amplitude de longitude couvre donc moins de terrain vers les pôles.

Le résultat est-il déterministe ?

Oui. Des valeurs identiques de latitude, longitude et résolution donnent toujours le même résultat.

Quel est le prix d’une requête ?

Une requête API coûte $0.002. La version pour navigateur exécute localement le même calcul pur.

Puis-je employer le centre comme centroïde géographique exact ?

Non. C’est le centre plan de la cellule approximative, à considérer comme une coordonnée représentative.

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.

POSThttps://api.kit.forhosting.com/geo/h3-cell-approx

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é.

curl -X POST https://api.kit.forhosting.com/geo/h3-cell-approx \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lat":37.7749,"lon":-122.4194}'
{
  "lat": 37.7749,
  "lon": -122.4194
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.h3_cell_approx",
  "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.

par requête$0.002

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

HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →