Encoder geohash

Un geohash trasforma una coppia di coordinate geografiche in una breve stringa base32 che identifica una cella rettangolare sulla Terra. I punti vicini condividono lunghi prefissi comuni, il che rende la codifica utile per la ricerca di prossimità, le chiavi dei tile, le partizioni di cache e i token di posizione leggibili. Questa capacità riceve latitudine, longitudine e una lunghezza di precisione, poi restituisce la stringa geohash insieme al riquadro di delimitazione della cella. L'algoritmo è pura aritmetica: nessuna chiamata di rete, nessun campionamento casuale e nessun orologio. Precisioni non valide o coordinate fuori intervallo vengono respinte con un chiaro errore di input, anziché con una cella sbagliata in silenzio.

Che cosa rappresenta davvero un geohash

Ogni carattere che aggiunge dimezza la cella grosso modo in una dimensione e poi nell'altra, quindi stringhe più lunghe descrivono rettangoli più piccoli. Un hash di un solo carattere copre un'ampia fetta del pianeta; nove o dieci caratteri sono di norma sufficienti per un isolato o l'impronta di un edificio, a seconda della latitudine. Poiché i prefissi si annidano, due posizioni che condividono i primi sette caratteri ricadono nella stessa cella grossolana, ed è esattamente ciò che rende pratiche le query per prefisso e il clustering sulla mappa.

La stringa non è un hash crittografico: punti diversi possono condividere un prefisso di proposito, e la stessa precisione produce sempre la stessa stringa per le stesse coordinate. La usi quando le serve una chiave compatta e sicura per URL che indichi un luogo, invece di una coppia in virgola mobile completa in ogni riga di log o record di database.

Come scegliere la precisione e inviare le coordinate

Invii gradi decimali sul globo WGS84: latitudine da meno novanta a novanta, longitudine da meno centottanta a centottanta. La precisione è il numero di caratteri base32 che vuole indietro, da uno a dodici. I valori bassi si adattano a raggruppamenti nazionali o regionali; quelli intermedi a città e quartieri; quelli alti a celle su scala di interni o di tracciamento veicoli.

La risposta ripete gli input inviati, il geohash risultante e i limiti di latitudine/longitudine della cella che quella stringa denota. Quei limiti sono gli intervalli con cui l'encoder ha concluso dopo l'ultimo bit, così può verificare la copertura senza decodificare a parte. Campi mancanti e valori non numerici falliscono allo stesso modo.

Preferisca numeri decimali stabili anziché stringhe con unità o lettere cardinali; converta i riferimenti DMS o di griglia prima di chiamare.

Dove si inseriscono le celle codificate nelle pipeline reali

Poiché la trasformazione è deterministica e priva di effetti collaterali, può rigenerare la stessa chiave nel browser, in un worker o in un processo batch e aspettarsi risultati identici byte per byte per gli stessi input. Ricordi che le celle geohash sono rettangoli nello spazio dei gradi, non cerchi perfetti di area uguale: vicino ai poli una cella lunga è molto più stretta in metri est-ovest della stessa lunghezza vicino all'equatore.

Per una ricerca per raggio rigorosa calcola comunque la distanza sui punti originali; usi l'hash per il raggruppamento e il recupero dei candidati, poi affini.