Skip to main content

API di arricchimento indirizzi

Geocoding, gerarchia di quartiere e POI nelle vicinanze in un'unica chiamata.

Fornisci un indirizzo. Ricevi coordinate, gerarchia del quartiere e luoghi vicini in un'unica risposta. Tutto ciò di cui le tue pagine di annunci hanno bisogno per diventare visibili all'IA, in una sola chiamata API.

Come funziona

Tre passi verso un annuncio completamente arricchito.

Nessun assemblaggio di più servizi. Un endpoint gestisce geocodifica, risoluzione del quartiere e ricerca POI in una singola chiamata.

01

Invia l'indirizzo

Passa qualsiasi stringa di indirizzo grezza, un codice postale o una coppia di coordinate a GET /v1/geoenrich. Nessuna pre-elaborazione o normalizzazione dell'indirizzo richiesta.

02

MapAtlas risolve il layer geo completo

L'API geocodifica l'indirizzo con precisione al tetto, risolve la gerarchia del quartiere e analizza oltre 1 miliardo di POI indicizzati entro il raggio scelto, restituendo valutazioni, linee di trasporto, orari di apertura e tempi di percorrenza.

03

Inietta nel JSON-LD e pubblica

Ogni campo nella risposta si mappa direttamente su una proprietà schema.org. Inserisci le coordinate in GeoCoordinates, il quartiere in containedInPlace e i luoghi vicini in amenityFeature. Nessuna trasformazione necessaria.

The API

Una chiamata. Intelligenza di localizzazione completa.

La maggior parte dei database di annunci memorizza ciò che gli utenti inseriscono: indirizzo, prezzo, camere. Non sono mai stati progettati per fornire un contesto geografico leggibile dalle macchine. GeoEnrich API colma quel divario in una singola richiesta, restituendo coordinate, analisi del quartiere, trasporti in tempo reale, valutazioni, tempi di percorrenza e molto altro.

  • Fornisci la stringa di indirizzo grezza. Nessuna pre-elaborazione necessaria.
  • Ricevi coordinate, gerarchia completa del quartiere e punteggi di profilo.
  • Ottieni luoghi vicini con valutazioni, orari di apertura e dati di trasporto live.
  • Ogni campo si mappa direttamente su una proprietà schema.org.
RequestGET
GET https://api.mapatlas.eu/v1/geoenrich
  ?address=Kollwitzstraße 65, Berlin
  &radius=600
  &categories=transit,education,leisure,supermarket
  &include=neighborhoodProfile,realtime,busyness
  &key=YOUR_API_KEY
ResponseJSON
{
  "address": {
    "street":     "Kollwitzstraße 65",
    "postalCode": "10405",
    "city":       "Berlin",
    "country":    "DE"
  },
  "coordinates": {
    "lat":      52.53841,
    "lng":      13.41327,
    "accuracy": "rooftop",
    "elevation": 42
  },
  "adminHierarchy": {
    "subDistrict":  "Kollwitzkiez",
    "neighborhood": "Prenzlauer Berg",
    "district":     "Pankow",
    "city":         "Berlin",
    "state":        "Berlin",
    "country":      "DE",
    "postalCode":   "10405"
  },
  "neighborhoodProfile": {
    "tags":         ["family-friendly", "trendy", "cycling-culture", "cafe-dense"],
    "walkScore":    94,
    "bikeScore":    91,
    "transitScore": 98,
    "noiseLevel":   "moderate",
    "airQualityIndex": 38,
    "greenSpaceCoverage": "18%"
  },
  "dataTimestamp": "2026-03-01T00:00:00Z",
  "radius":   600,
  "poiCount": 1328,
  "nearby": [
    {
      "name":          "Eberswalder Str.",
      "type":          "transit",
      "subtype":       "metro",
      "distance":      140,
      "bearing":       "NW",
      "lines":         ["U2"],
      "destinations":  ["Pankow", "Ruhleben"],
      "frequency":     "every 5 min (peak)",
      "accessibility": "step-free",
      "realtime": {
        "nextDeparture": "in 3 min",
        "direction":     "Pankow",
        "platform":      "platform 1"
      },
      "travel": {
        "walking": { "duration": "2 min", "distance": "140m" },
        "cycling": { "duration": "1 min", "distance": "150m" },
        "driving": { "duration": "1 min", "distance": "180m" }
      }
    },
    {
      "name":         "Bus 142 / N2 at Eberswalder Str.",
      "type":         "transit",
      "subtype":      "bus",
      "distance":     145,
      "bearing":      "NW",
      "lines":        ["142", "N2"],
      "destinations": ["Ostbahnhof", "Zoologischer Garten"],
      "frequency":    "every 10 min (day) / 30 min (night)",
      "realtime": {
        "nextDeparture": "in 7 min",
        "direction":     "Ostbahnhof"
      },
      "travel": {
        "walking": { "duration": "2 min", "distance": "145m" },
        "cycling": { "duration": "1 min", "distance": "155m" },
        "driving": { "duration": "1 min", "distance": "180m" }
      }
    },
    {
      "name":         "Kollwitzplatz",
      "type":         "leisure",
      "subtype":      "park",
      "distance":     210,
      "bearing":      "SE",
      "openingHours": "24/7",
      "size":         "1.2 ha",
      "amenities":    ["playground", "dog-friendly", "benches", "fountain", "market-tue-sat"],
      "rating":       4.6,
      "reviews":      1842,
      "busyness": {
        "now":  "quiet",
        "peak": "Sat 11:00-14:00"
      },
      "travel": {
        "walking": { "duration": "3 min", "distance": "210m" },
        "cycling": { "duration": "1 min", "distance": "225m" },
        "driving": { "duration": "1 min", "distance": "350m" }
      }
    },
    {
      "name":      "Grundschule am Kollwitzplatz",
      "type":      "education",
      "subtype":   "primary_school",
      "distance":  380,
      "bearing":   "E",
      "ageRange":  "6-12",
      "schoolType":"public",
      "capacity":  340,
      "languages": ["German", "English"],
      "rating":    4.2,
      "reviews":   156,
      "travel": {
        "walking": { "duration": "5 min", "distance": "380m" },
        "cycling": { "duration": "2 min", "distance": "410m" },
        "driving": { "duration": "2 min", "distance": "520m" }
      }
    },
    {
      "name":     "REWE Kollwitzstraße",
      "type":     "supermarket",
      "subtype":  "grocery",
      "distance": 490,
      "bearing":  "N",
      "openingHours": {
        "mon-sat": "07:00-22:00",
        "sun":     "08:00-22:00"
      },
      "priceLevel":        "$$",
      "deliveryAvailable": true,
      "paymentMethods":    ["card", "cash", "contactless"],
      "rating":  4.1,
      "reviews": 892,
      "busyness": {
        "now":  "busy",
        "peak": "Mon-Fri 17:00-19:00"
      },
      "travel": {
        "walking": { "duration": "6 min", "distance": "490m" },
        "cycling": { "duration": "2 min", "distance": "510m" },
        "driving": { "duration": "2 min", "distance": "650m" }
      }
    }
    // ... 1,323 more across 18 categories
  ]
}

Data at a scale and speed never available before

1B+

POIs indexed globally

Transit, retail, education & more

180+

Countries covered

Consistent schema everywhere

<200ms

Avg. API response

At any scale, any location

18

Data categories

Per single API call

Surrounding Context

Every nearby place, verified fresh.

One call returns every relevant place within your chosen radius, organized by category. Each dataset carries a dataTimestamp so AI engines and search crawlers know exactly how current your location data is.

  • Transit stops, parks, schools, restaurants, all in one response
  • Configurable radius from 100m to 5km
  • Monthly refresh cycle with verified timestamps
  • AI engines cite fresh, timestamped data over stale listings

Kollwitzstraße 65

Prenzlauer Berg · Berlin · DE

Nearby within 600m

Eberswalder Str.U2Pankow ↔ Ruhleben · 5 min freq.
2 min1 min1 min
140m
Bus 142 / N2 at EberswalderBUSOstbhf ↔ Zoo
2 min1 min1 min
145m
Kollwitzplatz 4.6leisure
3 min1 min1 min
210m
Grundschule am Kollwitzplatzeducationages 6–12
5 min2 min2 min
380m
REWE Kollwitzstraße 4.1
Mon–Sat 07:00–22:00 · Sun 08:00–22:00
6 min2 min2 min
490m
+ 1,323 more placesacross 18 categories in full response

Data verified · March 2026

Monthly refresh · dataTimestamp: 2026-03-01

Cosa restituisce una chiamata

Coordinates. Neighborhood profile. Nearby places.

Every field in the response maps directly to a schema.org property. Coordinates, neighborhood hierarchy, walkScore, transit lines, ratings, opening hours, travel times. No transformation needed.

Coordinate precise

lat/lng a precisione tetto con altitudine. Alimenta direttamente lo schema GeoCoordinates.

latlngelevation

Intelligenza del quartiere

Gerarchia completa più walkScore, bikeScore, transitScore, livello di rumorosità, indice di qualità dell'aria e tag di carattere. Alimenta containedInPlace e il contesto del quartiere.

neighborhooddistrictwalkScorenoiseLevel

Luoghi vicini ricchi

Oltre 1.328 POI con valutazioni, orari di apertura, linee di trasporto, partenze in diretta, tempi di percorrenza e dati sull'affluenza. Alimenta lo schema amenityFeature.

nametypedistancerealtimerating
GeoEnrich API

Semplice. Prevedibile. Un endpoint.

Nessuna configurazione complessa. Nessun assemblaggio di più chiamate. Fornisci un indirizzo, ricevi il layer geo completo necessario per alimentare il markup schema.org su ogni pagina di annuncio.

  • Un singolo endpoint gestisce geocodifica e ricerca POI insieme
  • Filtri opzionali per raggio e categoria per un controllo preciso
  • La risposta si mappa direttamente su JSON-LD senza trasformazione
  • Esegui in fase di build per zero costi ricorrenti per richiesta
Check your listing pages with the AEO Checker
JSON-LD outputschema.org
{
  "@context": "https://schema.org",
  "@type": "Apartment",
  "geo": {
    "@type": "GeoCoordinates",
    "latitude": 52.5384,
    "longitude": 13.4132
  },
  "containedInPlace": {
    "@type": "Place",
    "name": "Prenzlauer Berg",
    "containedInPlace": { "@type": "City", "name": "Berlin" }
  },
  "amenityFeature": [
    { "@type": "LocationFeatureSpecification",
      "name": "Eberswalder Str.", "value": true,
      "description": "140m nearby" }
  ],
  "dateModified": "2026-03-01T00:00:00Z"
}
Costruito per ogni tipo di annuncio

One API call. Every listing type.

The GeoEnrich API works for any listing: vacation rentals, real estate, hotels, or experiences. The API call is identical. Only the schema type differs. See how listing portals use this at scale.

Affitti vacanza

Fai apparire le singole pagine di affitto nelle query IA come 'villa sul mare vicino a Faro con ristoranti a piedi'.

Immobiliare

Mostra gli annunci per query come 'appartamenti a Prenzlauer Berg vicino alla metro' senza inserimento manuale dei dati.

Hotel

Ottieni citazioni IA per query come 'hotel boutique nel Marais, raggiungibile a piedi dai musei'.

Esperienze

Vieni citato per query come 'corso di cucina a Barcellona vicino al Quartiere Gotico'.

Tutto in una risposta

Un singolo endpoint restituisce il layer di dati geo completo di cui le tue pagine di annunci hanno bisogno per diventare visibili all'IA.

Coordinate precise

Precisione a quattro cifre decimali. Popola lo schema GeoCoordinates su ogni pagina di annuncio così i motori IA possono posizionarlo nello spazio geografico.

Gerarchia del quartiere

Quartiere, distretto, città e paese risolti dall'indirizzo. Alimenta la catena containedInPlace per il recupero IA a livello di area.

Luoghi nelle vicinanze

Trasporti, istruzione, tempo libero e assistenza sanitaria entro un raggio configurabile. Ogni luogo viene restituito con distanza e tempo a piedi per lo schema amenityFeature.

Aggiornamento mensile dei dati

Ogni risposta include un dataTimestamp aggiornato mensilmente. Mappalo su dateModified nel tuo JSON-LD affinché i motori IA vedano dati verificati e aggiornati.

Costruito per l'elaborazione massiva

Progettato per database di 50.000 annunci o più. Esegui il processo di arricchimento una volta in fase di build, metti in cache il layer geo e servi a costo zero per ogni richiesta.

Ospitato in UE, conforme al GDPR

Completamente ospitato in UE con documentazione di conformità GDPR e clausole contrattuali standard. Nessun rischio di residenza dei dati per i portali di annunci europei.

Specifiche tecniche

Endpoint

Metodo
GET /v1/geoenrich
Formato di risposta
JSON (schema.org-ready)

Parametri

address
Obbligatorio. Stringa indirizzo grezza.
radius
Metri. Predefinito 600.

Campi di risposta

coordinates
lat / lng (4 cifre decimali)
nearby[]
nome, tipo, distanza (metri)

Pronti per Iniziare?

Inizia a costruire con MapAtlas oggi. Registrati gratuitamente e ottieni accesso istantaneo a tutte le nostre API di mappatura con limiti generosi per il livello gratuito.

GeoEnrich API: domande frequenti

Tutto ciò che devi sapere prima di arricchire il tuo primo annuncio.

GeoEnrich API: domande frequenti

Tutto ciò che devi sapere prima di arricchire il tuo primo annuncio.

Quali dati restituisce la GeoEnrich API?
Una singola chiamata restituisce: coordinate con precisione al tetto (lat/lng), una gerarchia completa del quartiere (sotto-quartiere, quartiere, distretto, città, regione, paese, codice postale) e un elenco di luoghi vicini entro il raggio scelto. Ogni luogo vicino include nome, tipo, distanza, direzione, tempi di percorrenza a piedi, in bicicletta e in auto, oltre a dettagli ricchi come destinazioni delle linee di trasporto, orari di apertura, valutazioni e dati sull'affluenza in diretta. La risposta include anche un neighborhoodProfile con walkScore, bikeScore, transitScore, indice di qualità dell'aria e livello di rumorosità.
Qual è la differenza tra la GeoEnrich API e un'API di geocodifica?
Un'API di geocodifica converte un indirizzo in coordinate. La GeoEnrich API va molto oltre: combina la geocodifica con la risoluzione del quartiere e una ricerca POI completa in un'unica chiamata. Invece di restituire una coppia lat/lng, restituisce tutto ciò di cui una pagina di annuncio ha bisogno per diventare visibile all'IA, inclusi campi pronti per schema.org per GeoCoordinates, containedInPlace e amenityFeature.
Con quale frequenza vengono aggiornati i dati di localizzazione?
I dati POI, gli orari dei trasporti, le valutazioni e gli orari di apertura vengono aggiornati su base mensile. Ogni risposta include un campo dataTimestamp per mostrare la data di aggiornamento come dateModified nel tuo JSON-LD. I motori IA e i crawler trattano i dati con timestamp recenti come più affidabili, migliorando i tassi di citazione.
La GeoEnrich API funziona per tutti i paesi?
Sì. L'API copre oltre 180 paesi con output JSON coerente e lo stesso mapping dei campi schema.org ovunque. La profondità di copertura varia per regione: le città europee hanno i dati POI e di trasporto più dettagliati, mentre la copertura globale include coordinate, gerarchia del quartiere e categorie POI principali.
Posso eseguire GeoEnrich su un grande database di annunci?
L'API è specificamente costruita per l'uso in blocco. Esegui il processo di arricchimento una volta in fase di build, metti in cache il layer geo per annuncio e servi senza costi ricorrenti per richiesta. Il piano gratuito include 50.000 arricchimenti al mese. I piani più grandi supportano una velocità effettiva più elevata con supporto per endpoint batch.
Come aiutano i dati di localizzazione le pagine di annunci a posizionarsi nella ricerca IA?
I motori di ricerca IA come Perplexity, ChatGPT e Google AI Overviews rispondono a query come 'appartamenti vicino alla metro a Prenzlauer Berg' leggendo i dati strutturati nel tuo HTML. Senza il markup schema.org per GeoCoordinates, containedInPlace e amenityFeature, i tuoi annunci sono invisibili a questi motori, indipendentemente dal loro posizionamento su Google. GeoEnrich fornisce esattamente i dati geo necessari per popolare quel markup su larga scala.
La GeoEnrich API è conforme al GDPR?
Sì. Tutta l'elaborazione avviene su infrastruttura ospitata in UE. Indirizzi e coordinate non vengono memorizzati oltre il ciclo di vita della richiesta. MapAtlas fornisce clausole contrattuali standard e documentazione di conformità GDPR per i portali di annunci europei e i responsabili del trattamento dei dati.
La GeoEnrich API può restituire la posizione geografica di un indirizzo IP?
Sì. Passi un indirizzo IP e GeoEnrich ne restituisce la posizione geografica approssimativa, inclusi paese, regione, città e coordinate. La geolocalizzazione tramite IP è utile per centrare la mappa di default, per i segnali antifrode e per localizzare i contenuti prima che un utente condivida una posizione precisa. Tutte le ricerche vengono eseguite su infrastruttura ospitata in UE.
Quanto è precisa la geolocalizzazione tramite IP rispetto alle coordinate GPS?
La geolocalizzazione tramite IP arriva a livello di città o regione, non alla precisione a livello di strada del GPS. Usala per impostazioni di default approssimative e per le analytics, e ricorri alla Geocoding API o al GPS del dispositivo quando ti serve un indirizzo o un punto esatto. GeoEnrich ti permette di combinare entrambi in un'unica chiamata di arricchimento.