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.
Esegui gratis nel browser
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.
Casi d'uso
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.
Domande frequenti
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.
Per sviluppatori — accesso via API
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.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
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}'const res = await fetch("https://api.kit.forhosting.com/geo/what3words-grid-index", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"lat": 51.520847,
"lon": -0.195521
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/geo/what3words-grid-index",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"lat": 51.520847,
"lon": -0.195521
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/what3words-grid-index", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"lat":51.520847,"lon":-0.195521}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"lat":51.520847,"lon":-0.195521}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/what3words-grid-index", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"lat": 51.520847,
"lon": -0.195521
}Esempio di risposta
{
"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.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |