ForHosting KIT · Strumenti per sviluppatori

Indice a griglia di tre metri da latitudine e longitudine

L’indice a griglia di tre metri associa un indirizzo numerico stabile a ogni coppia di latitudine e longitudine.

● BetaGratis · nel tuo browser
Usalo da WebAPIEmailTelegramApp presto

Suddivide il globo in sottili righe di latitudine e dimensiona le colonne di longitudine di ciascuna riga per ottenere un’area di circa tre metri. La risposta contiene l’indice combinato, la riga, la colonna, il numero di colonne della riga, il centro e i confini geografici. È utile quando serve una chiave di posizione compatta e ripetibile più di un indirizzo stradale, senza interrogazioni di rete o dizionari di parole proprietari.

Converta una coordinata in un indirizzo numerico ripetibile

Inserisca `lat` e `lon` in gradi decimali e il calcolatore assegnerà il punto a una sola cella globale. Il valore principale `grid_index` unisce la riga di latitudine e la colonna di longitudine con un punto, creando una chiave compatta che Lei può archiviare, confrontare, registrare o inserire in una URL. I campi distinti `row` e `column` semplificano l’ordinamento e le operazioni nel database, mentre `columns_in_row` descrive la geometria della fascia di latitudine scelta. Gli stessi input finiti producono sempre lo stesso risultato, perché l’algoritmo non utilizza richieste di rete, casualità, orologi o tabelle di riferimento modificabili. Le coordinate sui confini ordinari seguono una regola coerente di intervallo semiaperto: i bordi meridionale e occidentale sono inclusi, quelli settentrionale e orientale sono esclusi. Il Polo Nord viene assegnato esplicitamente all’ultima riga, mentre la longitudine 180 gradi è considerata lo stesso antimeridiano di -180 gradi. Queste convenzioni eliminano gli indirizzi duplicati e ambigui ai margini del sistema di coordinate.

Comprenda il significato di tre metri su una griglia sferica

Il calcolo rappresenta la Terra come una sfera con raggio medio fisso. Crea righe di latitudine ad angolo uguale la cui distanza da nord a sud non supera tre metri. Per ogni riga misura la circonferenza del parallelo passante per il centro e sceglie abbastanza colonne di longitudine affinché anche la loro larghezza sulla linea centrale non superi tre metri. Il numero di colonne diminuisce quindi verso i poli, dove i circoli di latitudine diventano più corti. Questo metodo è più utile dell’applicazione di un unico passo di longitudine ovunque, che renderebbe le celle progressivamente più strette da est a ovest alle alte latitudini. I confini restituiti descrivono l’esatto rettangolo angolare usato dalla definizione e il centro offre una comoda coordinata rappresentativa. Le dimensioni fisiche restano approssimative: la Terra non è una sfera perfetta, il terreno aggiunge distanza superficiale e gli strumenti di posizionamento hanno una propria incertezza. Usi l’indice per raggruppamenti e indirizzamenti deterministici, non come sostituto di confini catastali, navigazione critica o rilievi geodetici professionali.

Usi l’indice correttamente nei sistemi di dati

Memorizzi `grid_index` come testo, perché contiene due interi potenzialmente grandi separati da un punto. Non interpreti il valore combinato come numero in virgola mobile: perderebbe la distinzione tra riga e colonna e, in alcuni ambienti, anche precisione intera. Per le chiavi composte di un database può ugualmente conservare `row` e `column` in colonne intere separate; includa una versione o il nome della griglia nei set di dati destinati a durare, così un algoritmo futuro non verrà confuso con questa definizione. Coordinate vicine spesso condividono un indice, rendendo la chiave utile per deduplicazione, registri approssimativi di presenza, partizioni di cache e aggregazioni attente alla riservatezza. Tuttavia, due punti separati dal confine di una cella ricevono chiavi diverse anche se distano pochi centimetri. Se conta la prossimità, confronti la cella selezionata e le righe e colonne adiacenti oppure calcoli la distanza effettiva. Lo schema si ispira alla scala approssimativa associata a what3words, ma è numerico e indipendente: non converte indirizzi ufficiali di tre parole e non riproduce identificatori o assegnazioni proprietarie.

Raggruppare segnalazioni ripetute di posizione

Riunisca le osservazioni nella stessa piccola cella conservando una chiave deterministica per confronti successivi.

Creare riferimenti cartografici compatti

Rappresenti una coordinata con riga e colonna numeriche quando la notazione decimale completa è scomoda.

Partizionare registrazioni spaziali

Usi riga e colonna come partizioni prevedibili di database o cache per dati puntuali.

Il risultato è un indirizzo what3words ufficiale?

No. È un indice numerico indipendente e non usa né riproduce il dizionario di parole o il servizio di indirizzamento ufficiale di what3words.

Tutte le celle sono quadrati esatti di tre metri?

No. Sono celle sferiche di latitudine e longitudine progettate per misurare circa tre metri o meno in altezza e larghezza al centro di ogni riga. Ellissoide, terreno e poli introducono variazioni.

Che cosa contiene l’indice della griglia?

Contiene la riga di latitudine con base zero, un punto e la colonna di longitudine con base zero di quella riga. La risposta restituisce anche i due numeri separatamente.

Perché il numero di colonne cambia tra le righe?

I circoli di latitudine si accorciano verso i poli. Variare il numero di colonne mantiene la larghezza est-ovest vicina alla scala prevista.

Come vengono gestite le coordinate su un confine?

I bordi meridionale e occidentale appartengono alla cella, mentre quelli settentrionale e orientale portano alla successiva. Regole speciali collocano il Polo Nord nell’ultima riga ed equiparano 180 a -180.

Quanto costa una richiesta API?

Ogni richiesta API costa $0.002. La stessa logica deterministica può essere eseguita localmente anche nel browser.

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/what3words-grid-index

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/what3words-grid-index \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lat":51.520847,"lon":-0.195521}'
{
  "lat": 51.520847,
  "lon": -0.195521
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.what3words_grid_index",
  "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 →