ForHosting KIT · Strumenti per sviluppatori

Allineare latitudine e longitudine a una griglia

Trasformi una coordinata geografica continua in un indirizzo di griglia stabile mediante un calcolo deterministico.

● BetaGratis · nel tuo browser
Usalo da WebAPIEmailTelegramApp presto

Indichi latitudine, longitudine e distanza fra i nodi in gradi decimali; se necessario, sposti la griglia scegliendo un’origine personalizzata. Il risultato comprende la coordinata allineata, gli indici interi della griglia e gli scostamenti con segno dal punto originale. In questo modo Lei può raggruppare, confrontare e memorizzare nella cache le coordinate, oppure usarle come celle spaziali compatte, senza dipendere da un servizio remoto di geocodifica o da un sistema informativo geografico complesso.

Scelga una griglia adatta al Suo indice

Una griglia geografica regolare suddivide latitudine e longitudine in intervalli ripetibili. Per iniziare, fornisca una coordinata e una spaziatura positiva in gradi decimali. Una spaziatura minore crea più nodi e conserva maggiori dettagli sulla posizione; una maggiore raggruppa un’area più ampia sotto la stessa coordinata allineata. La spaziatura viene applicata separatamente ai due assi, quindi il risultato è una griglia rettangolare in unità angolari. Questo approccio è utile per indicizzazione spaziale quantizzata, aggregazione, chiavi di cache, deduplicazione approssimativa e riduzione della precisione a tutela della riservatezza. Ricordi che i gradi sono unità angolari: la distanza al suolo rappresentata da un grado di longitudine diminuisce avvicinandosi ai poli. Se Le servono celle di dimensione quasi costante in metri su una regione vasta, proietti prima i dati in un sistema di coordinate piano adatto. Per insiemi locali o volutamente basati sui gradi, l’allineamento diretto è spesso la scelta più semplice e trasparente. Il calcolo non deduce la spaziatura e non cambia silenziosamente le unità, perciò ogni risultato rimane riproducibile dagli input dichiarati.

Controlli l’allineamento tramite l’origine

Per impostazione predefinita, la griglia è ancorata a zero gradi di latitudine e zero gradi di longitudine. Ogni nodo equivale all’origine più un multiplo intero della spaziatura scelta su ciascun asse. Lei può specificare origin_lat e origin_lon quando una tassellazione esistente usa un allineamento diverso. Ciò è importante perché due griglie con la stessa spaziatura ma origini differenti producono celle diverse. Gli indici restituiti indicano il numero con segno di passi dall’origine e costituiscono una pratica chiave composta quando viene conservata anche la definizione della griglia. Latitudine e longitudine sono allineate in modo indipendente. Se un punto si trova esattamente a metà, il pareggio viene risolto allontanandosi dall’indice zero, con un esito stabile per coordinate positive e negative. Ai limiti geografici, il calcolo sceglie il nodo più vicino appartenente alla griglia dichiarata che resti negli intervalli validi. Non restituisce mai una latitudine oltre 90 gradi o una longitudine oltre 180 gradi solo perché un nodo aritmetico non vincolato sarebbe più vicino.

Interpreti coordinate e scostamenti

La risposta restituisce come risultato principale la latitudine e la longitudine allineate, insieme a lat_index e lon_index. Riporta inoltre le variazioni con segno in gradi. Uno scostamento positivo della latitudine indica che il nodo si trova a nord del punto fornito; uno scostamento negativo della longitudine indica che si trova a ovest. Questi dati Le consentono di verificare la quantizzazione introdotta o di rifiutare record il cui spostamento superi una soglia stabilita dalla Sua applicazione. I risultati sono arrotondati a dodici cifre decimali per eliminare il rumore binario irrilevante senza perdere dettagli inferiori alla spaziatura minima accettata. L’operazione è deterministica, non usa la rete e non conserva stato; lo stesso input JSON produce quindi la stessa uscita nel browser e tramite API. Una richiesta elabora una coordinata e costa $0.002 tramite API. Nei flussi in batch, richiami la capacità per ogni elemento e conservi spaziatura e origine insieme agli indici, così chi consulterà i dati potrà ricostruire la definizione esatta della griglia senza dedurla dai valori allineati.

Creare chiavi di cache spaziali

Converta osservazioni vicine nella stessa coppia di indici interi prima di leggere o scrivere una cache.

Aggregare eventi di posizione

Raggruppi record puntuali in celle regolari basate sui gradi per conteggi, riepiloghi o preparazione di mappe.

Ridurre la precisione delle coordinate

Sostituisca coordinate dettagliate con nodi dichiarati quando l’applicazione richiede solo posizioni approssimative.

Quanto costa una richiesta?

Ogni richiesta API costa $0.002. La versione nel browser esegue localmente lo stesso calcolo deterministico.

La spaziatura è misurata in metri?

No. È espressa in gradi decimali e applicata separatamente a latitudine e longitudine.

Come vengono gestiti i pareggi esatti?

Una coordinata esattamente a metà tra due indici viene allineata allontanandosi dall’indice zero, su entrambi i lati dell’origine.

Posso allineare una griglia esistente?

Sì. Imposti origin_lat e origin_lon sull’ancora di quella griglia e mantenga la stessa spaziatura.

Il risultato può superare i limiti geografici?

No. Il nodo scelto resta sulla griglia dichiarata e negli intervalli validi di latitudine e longitudine.

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

POSThttps://api.kit.forhosting.com/geo/snap-to-grid

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

curl -X POST https://api.kit.forhosting.com/geo/snap-to-grid \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lat":37.7749,"lon":-122.4194,"spacing_deg":0.01}'
{
  "lat": 37.7749,
  "lon": -122.4194,
  "spacing_deg": 0.01
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.snap_to_grid",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

HTTPCodiceSignificato
401unauthorizedChiave API mancante o non valida: controlla l'header Authorization.
402insufficient_balanceCredito esaurito: ricarica per continuare a eseguire attività.
404unknown_typeTipo di attività sconosciuto: controlla il campo type della richiesta.
429rate_limitedTroppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →