Encodeur geohash

Un geohash transforme un couple de coordonnées géographiques en une courte chaîne base32 qui identifie une cellule rectangulaire à la surface de la Terre. Les points voisins partagent de longs préfixes communs, ce qui rend l'encodage utile pour la recherche de proximité, les clés de tuiles, le partitionnement de cache et les jetons de localisation lisibles. L'algorithme est purement arithmétique : aucun appel réseau, aucun échantillonnage aléatoire et aucune horloge. Une précision invalide ou des coordonnées hors plage sont rejetées par une erreur d'entrée claire plutôt que par une cellule erronée silencieuse.

Ce que représente réellement un geohash

Chaque caractère ajouté divise environ la cellule par deux dans une dimension puis dans l'autre, de sorte que les chaînes plus longues décrivent des rectangles plus petits. Un hash d'un seul caractère couvre une immense portion de la planète ; neuf ou dix caractères suffisent généralement pour un pâté de maisons ou l'emprise d'un bâtiment, selon la latitude. Comme les préfixes s'emboîtent, deux emplacements qui partagent les sept premiers caractères tombent dans la même cellule grossière, ce qui rend précisément praticables les requêtes par préfixe et le regroupement cartographique.

La chaîne n'est pas un hash cryptographique : des points différents peuvent partager un préfixe à dessein, et la même précision produit toujours la même chaîne pour les mêmes coordonnées. Utilisez-le lorsque vous avez besoin d'une clé compacte et compatible avec les URL pour un lieu, plutôt que d'un couple de flottants complet dans chaque ligne de journal ou de base de données.

Comment choisir la précision et transmettre les coordonnées

La précision est le nombre de caractères base32 souhaités en retour, de un à douze. Les valeurs faibles conviennent aux compartiments nationaux ou régionaux ; les valeurs moyennes conviennent aux villes et aux quartiers ; les valeurs élevées conviennent aux cellules à l'échelle d'un intérieur ou du suivi de véhicules. Les champs manquants et les valeurs non numériques échouent de la même façon.

Préférez des nombres décimaux stables plutôt que des chaînes avec des unités ou des lettres cardinales ; convertissez les références DMS ou de grille avant l'appel.

Où s'insèrent les cellules encodées dans les pipelines réels

Les équipes utilisent les geohash comme clés de partition dans les magasins de séries temporelles, comme identifiants de tuiles pour les caches côté client, comme préfixes partagés pour les filtres de points voisins, et comme jetons courts dans les URL ou les charges utiles de QR lorsqu'un couple lat/lon complet est peu commode.

Comme la transformation est déterministe et sans effet de bord, vous pouvez régénérer la même clé dans le navigateur, dans un worker ou dans un traitement par lots et obtenir des résultats identiques au bit près pour les mêmes entrées. Cela compte pour les tests de référence, les répliques multirégionales et les outils hors ligne qui ne doivent pas dériver.

Rappelez-vous que les cellules geohash sont des rectangles dans l'espace des degrés, et non des cercles parfaits d'aire égale : près des pôles, une cellule d'une longueur donnée est bien plus étroite en mètres d'est en ouest que la même longueur près de l'équateur. Pour une recherche stricte par rayon, calculez toujours la distance sur les points d'origine ; utilisez le hash pour le regroupement et la récupération de candidats, puis affinez.