Una suite completa di API geografiche per geocoding, routing e mappe vettoriali, ospitata sui nostri server in Italia. Compatibile con i principali standard di mercato, con tariffe trasparenti e fallback automatico per garantire zero downtime.
Una sola chiave API per accedere a tutti i servizi geografici. Standard di mercato, integrazione semplice.
Converti un indirizzo testuale in coordinate latitudine/longitudine. Risposta nel formato standard di settore.
GET /v1/geo/geocode?q=...
Converti coordinate in un indirizzo leggibile e completo, con address_components nel formato standard.
GET /v1/geo/reverse?lat=&lon=
Suggerimenti indirizzi in tempo reale durante la digitazione. Include coordinate lat/lng senza chiamate aggiuntive.
GET /v1/geo/autocomplete?q=...
Calcolo percorsi ottimali in auto con OSRM. Formato di risposta standard, integrazione immediata.
GET /v1/geo/route/car?coords=...
Percorsi pedonali ottimizzati. Distanze, durate e indicazioni passo-passo nel formato standard di settore.
GET /v1/geo/route/foot?coords=...
Percorsi ciclabili che evitano strade pericolose e privilegiano piste ciclabili.
GET /v1/geo/route/bike?coords=...
Tile server con stile OSM Bright per applicazioni web e mobile. Compatibile MapLibre GL e Mapbox GL.
GET /v1/geo/tiles/style.json
Una sola chiave API per accedere a tutti i servizi geo: geocoding, routing, tiles, autocomplete e fallback automatico.
Una chiave, tutti gli endpoint
Privacy, controllo dei dati, prezzi trasparenti e infrastruttura italiana.
Inizia oraTutti i dati di geolocalizzazione passano dai nostri server in Italia. Nessuna terza parte coinvolta.
Se i nostri server non sono raggiungibili, le richieste vengono inoltrate automaticamente a un provider di backup. Zero downtime.
Formato di risposta JSON conforme allo standard di mercato. Integrazione immediata con le librerie più diffuse.
Tariffe competitive, fatturazione in euro, senza limiti free tier nascosti, senza sorprese a fine mese.
I nostri endpoint seguono i più diffusi standard di mercato. La chiave API può essere trasmessa in tre modi: header X-API-KEY, header Authorization: Bearer, oppure query string ?key= in stile Google Maps.
fetch('https://api.runai.it/v1/geo/geocode?q=Via+Roma+Milano', {
headers: { 'X-API-KEY': 'sk-runai-geo-...' }
})
.then(r => r.json())
.then(data => {
const loc = data.results[0].geometry.location;
console.log(loc.lat, loc.lng);
});// Stile Google Maps: la chiave va in query string.
// Usa sempre restrizioni dominio nel portale!
const apiKey = 'sk-runai-geo-...';
const q = encodeURIComponent('Via Roma Milano');
fetch(`https://api.runai.it/v1/geo/geocode?q=${q}&key=${apiKey}`)
.then(r => r.json())
.then(data => {
console.log(data.results[0].geometry.location);
});Ogni API Key può essere ristretta a specifici indirizzi IP o domini web, proprio come le API Key di Google Maps. Così anche se esponi la chiave lato frontend, nessuno potrà usarla al di fuori della tua applicazione.
Gestisci le chiaviSpecifica un elenco di IP o range CIDR (es. 10.0.0.0/24). Solo le richieste provenienti da questi IP saranno accettate.
Specifica i domini autorizzati (es. *.miosito.it). Il sistema verifica gli header Referer e Origin delle richieste.
Le richieste non autorizzate ricevono risposta 403 Forbidden. Il traffico bloccato non viene conteggiato nei tuoi consumi.
Puoi aggiornare le restrizioni dalla pagina API Keys senza dover rigenerare la chiave.
Le nostre mappe vettoriali coprono tutta l'Europa (dall'Islanda a Mosca, da Lisbona ad Atene) con dati OpenStreetMap costantemente aggiornati. I servizi di geocoding, reverse, autocomplete e routing sono invece dedicati al territorio italiano: indirizzi, vie, città, percorsi auto/piedi/bici basati sul dataset italiano.
Il fallback automatico entra in azione solo a livello infrastrutturale: se per qualsiasi motivo i nostri server non rispondono, le richieste vengono inoltrate a un provider esterno di backup per garantire continuità di servizio.
Dataset completo di vie, civici, comuni, province e CAP italiani. Aggiornato regolarmente.
Calcolo percorsi auto, piedi e bici sulla rete stradale italiana, ottimizzato per velocità.
Tile vettoriali per tutta l'Europa, compatibili MapLibre GL e Mapbox GL, perfetti per applicazioni che mostrano cartografia.
Se i nostri server non rispondono, il sistema inoltra automaticamente la richiesta a un provider esterno di backup. Zero downtime per la tua applicazione.
Crea il tuo account, genera una chiave Geo e inizia a usare le API in meno di 2 minuti.