Recuperi un Plus Code abbreviato da coordinate vicine
Un Plus Code abbreviato è pratico quando l’area generale è già nota, ma da solo non può identificare un luogo.
Esegui gratis nel browser
Questo strumento ripristina il prefisso mancante combinando l’Open Location Code corto con una latitudine e una longitudine di riferimento vicine. Restituisce il codice completo recuperato, le coordinate del suo centro e i limiti di latitudine e longitudine dell’area codificata. Il calcolo è deterministico, non consulta mappe e rispetta le regole di selezione delle celle previste da Open Location Code.
Perché un Plus Code abbreviato richiede un punto di riferimento
Un Plus Code completo contiene all’inizio i caratteri che individuano una zona ampia e, verso la fine, caratteri con precisione progressivamente maggiore. Il codice abbreviato elimina volutamente una parte del prefisso generale, perché chi lo condivide conosce già la città, il quartiere o un punto di riferimento vicino. Per esempio, un cartello o un messaggio locale può mostrare soltanto alcuni caratteri prima del segno più. I caratteri rimanenti descrivono celle di una griglia che si ripetono in tutto il mondo, quindi il testo isolato è ambiguo. Il recupero fornisce il contesto mancante attraverso una latitudine e una longitudine di riferimento. Il calcolatore codifica innanzitutto quelle coordinate vicine con la precisione standard a coppie, prende esattamente il numero di caratteri iniziali omessi dal codice corto e unisce tale prefisso al codice inserito. Poi confronta il centro della cella ottenuta con il punto di riferimento. La procedura non cerca indirizzi, attività commerciali, strade o aree amministrative. Ripristina l’Open Location Code completo geograficamente più vicino che sia coerente con il testo abbreviato e con le coordinate fornite. Una posizione appartenente alla stessa località è quindi un’informazione indispensabile, non un semplice suggerimento facoltativo per migliorare la precisione.
Come viene scelto il codice corrispondente più vicino
In genere è sufficiente copiare un prefisso ricavato dalle coordinate di riferimento, ma i luoghi prossimi al confine di una cella richiedono un ulteriore passaggio. Il codice completo provvisorio viene decodificato in un’area rettangolare con un centro e limiti a nord, sud, est e ovest. Il calcolatore determina la risoluzione del prefisso omesso e confronta il centro provvisorio con il riferimento. Se il centro dista più della metà di tale risoluzione, il candidato viene spostato di una cella equivalente verso il riferimento, rispettando i limiti di latitudine ai poli. La longitudine viene normalizzata attraverso l’antimeridiano; in questo modo, un punto vicino situato oltre i 180 gradi non produce un risultato lontano. Il codice definitivo viene nuovamente decodificato e restituito con limiti e coordinate centrali espliciti. Questo metodo applica l’interpretazione dell’area compatibile più vicina prevista per un Plus Code corto. Non afferma che il centro coincida con l’ingresso di un edificio né che ogni punto della cella abbia lo stesso indirizzo postale. I limiti descrivono l’area della griglia codificata, mentre il codice completo è l’identificatore portatile che Lei può archiviare o trasferire a un’altra implementazione di Open Location Code.
Come scegliere le coordinate e interpretare il risultato
Utilizzi coordinate realmente vicine al luogo in cui è stato creato il codice corto. Il centro di una città, un punto di passaggio già noto o la posizione GPS corrente possono essere adeguati se si trovano nella stessa zona. Più il codice viene abbreviato, maggiore è la porzione di prefisso geografico rimossa e più diventa importante la vicinanza del riferimento: coordinate imprecise o lontane possono selezionare un’altra cella ripetuta che corrisponde comunque ai caratteri rimasti. Dopo il recupero, controlli sia full_code sia il centro restituito. I campi latitude_lo, latitude_hi, longitude_lo e longitude_hi mostrano il rettangolo esatto codificato dal risultato e sono utili per inquadrare una mappa o verificare se un punto è incluso. Conservi il codice corto originale e le coordinate di riferimento in un registro di controllo quando la riproducibilità è importante, perché il risultato completo deriva da entrambi. Gli input utilizzano gradi decimali; la latitudine deve rimanere tra i poli e la longitudine nell’intervallo convenzionale con segno. L’operazione non usa servizi di rete, database cartografici, l’ora corrente o scelte casuali. Lo stesso input valido genera quindi sempre il medesimo codice recuperato e la stessa area numerica, sia in modalità interattiva sia in un flusso automatizzato al costo di $0.002 per richiesta.
Casi d'uso
Completi un codice ricevuto in un messaggio locale
Combini un codice corto di quartiere con coordinate vicine note prima di archiviarlo o condividerlo a livello globale.
Normalizzi i dati dei rilievi sul campo
Trasformi codici abbreviati e coordinate di riferimento in identificatori completi dotati di limiti decodificati espliciti.
Prepari dati di navigazione per un altro sistema
Recuperi codici completi portatili prima di esportare punti di passaggio verso software che non accettano Plus Code abbreviati.
Domande frequenti
Che cosa serve per recuperare un Plus Code abbreviato?
Fornisca il codice corto e una latitudine e longitudine vicine in gradi decimali. Tutti e tre i valori sono necessari, poiché il prefisso omesso rappresenta il contesto geografico.
Quanto devono essere vicine le coordinate di riferimento?
Devono appartenere alla stessa località del luogo desiderato. Più caratteri vengono omessi, più è importante utilizzare un riferimento realmente vicino.
Lo strumento può recuperare un indirizzo o il nome di un luogo?
No. Esegue esclusivamente i calcoli di Open Location Code e non consulta mappe, geocodificatori, elenchi commerciali o database postali.
Perché il codice completo include anche i limiti?
Un Plus Code rappresenta un’area, non un punto dalla precisione infinita. I limiti e il centro rendono esplicito il rettangolo codificato.
Posso inviare un Plus Code già completo?
No. Questa capacità recupera specificamente codici abbreviati e rifiuta un codice il cui segno più occupa già la posizione riservata al codice completo.
Quanto costa una richiesta API?
Ogni richiesta API costa $0.002. La versione per browser viene eseguita localmente senza inviare il calcolo a un servizio cartografico.
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/plus-code-recover \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"short_code":"9G8F+6X","latitude":47.36559,"longitude":8.524997}'const res = await fetch("https://api.kit.forhosting.com/geo/plus-code-recover", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"short_code": "9G8F+6X",
"latitude": 47.36559,
"longitude": 8.524997
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/geo/plus-code-recover",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"short_code": "9G8F+6X",
"latitude": 47.36559,
"longitude": 8.524997
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/plus-code-recover", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"short_code":"9G8F+6X","latitude":47.36559,"longitude":8.524997}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"short_code":"9G8F+6X","latitude":47.36559,"longitude":8.524997}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/plus-code-recover", 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
{
"short_code": "9G8F+6X",
"latitude": 47.36559,
"longitude": 8.524997
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "geo.plus_code_recover",
"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. |