Skip to main content

API de enriquecimiento de direcciones

Geocodificación, jerarquía de barrio y POIs cercanos en una sola llamada.

Envíe una dirección. Reciba coordenadas, jerarquía de barrio y lugares cercanos en una sola respuesta. Todo lo que sus páginas de anuncios necesitan para ser visibles para la IA, en una sola llamada API.

Cómo funciona

Tres pasos hacia un anuncio completamente enriquecido.

Sin ensamblar múltiples servicios. Un endpoint gestiona geocodificación, resolución de barrio y búsqueda de POI en una sola llamada.

01

Envíe la dirección

Pase cualquier cadena de dirección en bruto, un código postal o un par de coordenadas a GET /v1/geoenrich. No se requiere preprocesamiento ni normalización de dirección.

02

MapAtlas resuelve la capa geo completa

La API geocodifica la dirección con precisión de tejado, resuelve la jerarquía del barrio y escanea más de mil millones de POIs indexados dentro de su radio elegido, devolviendo valoraciones, líneas de transporte, horarios de apertura y tiempos de desplazamiento.

03

Inyecte en su JSON-LD y publique

Cada campo en la respuesta se mapea directamente a una propiedad schema.org. Inserte las coordenadas en GeoCoordinates, el barrio en containedInPlace y los lugares cercanos en amenityFeature. No se requiere transformación.

The API

Una llamada. Inteligencia de localización completa.

La mayoría de las bases de datos de anuncios almacenan lo que los usuarios introducen: dirección, precio, dormitorios. Nunca fueron diseñadas para proporcionar contexto geográfico legible por máquinas. GeoEnrich API cierra esa brecha en una sola solicitud, devolviendo coordenadas, análisis de barrio, transporte en tiempo real, valoraciones, tiempos de desplazamiento y más.

  • Envíe la cadena de dirección en bruto. No se requiere preprocesamiento.
  • Reciba coordenadas, jerarquía completa del barrio y puntuaciones de perfil.
  • Obtenga lugares cercanos con valoraciones, horarios de apertura y datos de transporte en vivo.
  • Cada campo se mapea directamente a una propiedad 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

Qué devuelve una llamada

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.

Coordenadas precisas

lat/lng de precisión de tejado con elevación. Alimenta directamente el esquema GeoCoordinates.

latlngelevation

Inteligencia de barrio

Jerarquía completa más walkScore, bikeScore, transitScore, nivel de ruido, índice de calidad del aire y etiquetas de carácter. Alimenta containedInPlace y el contexto del barrio.

neighborhooddistrictwalkScorenoiseLevel

Lugares cercanos enriquecidos

Más de 1.328 POIs con valoraciones, horarios de apertura, líneas de transporte, salidas en directo, tiempos de desplazamiento y datos de afluencia. Alimenta el esquema amenityFeature.

nametypedistancerealtimerating
GeoEnrich API

Simple. Predecible. Un endpoint.

Sin configuración compleja. Sin ensamblar múltiples llamadas. Envíe una dirección, reciba la capa geo completa necesaria para alimentar el marcado schema.org en cada página de anuncio.

  • Un único endpoint gestiona geocodificación y búsqueda de POI juntos
  • Filtros opcionales de radio y categoría para un control preciso
  • La respuesta se mapea directamente a JSON-LD sin transformación
  • Ejecutar en tiempo de construcción para cero costes recurrentes por solicitud
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"
}
Diseñado para cada tipo de anuncio

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.

Alquileres vacacionales

Haga que las páginas de alquiler individuales aparezcan en consultas IA como 'villa frente al mar cerca de Faro con restaurantes a pie'.

Inmobiliaria

Muestre anuncios para consultas como 'apartamentos en Prenzlauer Berg cerca del metro' sin entrada manual de datos.

Hoteles

Gane citas IA para consultas como 'hotel boutique en el Marais, a pie de los museos'.

Experiencias

Sea citado para consultas como 'clase de cocina en Barcelona cerca del Barrio Gótico'.

Todo en una respuesta

Un solo endpoint devuelve la capa de datos geo completa que sus páginas de anuncios necesitan para ser visibles para la IA.

Coordenadas precisas

Precisión de cuatro decimales. Rellena el esquema GeoCoordinates en cada página de anuncio para que los motores de IA puedan ubicarlo en el espacio geográfico.

Jerarquía de barrio

Barrio, distrito, ciudad y país resueltos a partir de la dirección. Alimenta la cadena containedInPlace para la recuperación IA a nivel de área.

Lugares cercanos

Transporte, educación, ocio y sanidad dentro de un radio configurable. Cada lugar se devuelve con distancia y tiempo a pie para el esquema amenityFeature.

Actualización mensual de datos

Cada respuesta incluye un dataTimestamp actualizado mensualmente. Asócielo a dateModified en su JSON-LD para que los motores IA vean datos verificados y actualizados.

Diseñado para procesamiento masivo

Diseñado para bases de datos de 50.000 anuncios o más. Ejecute el trabajo de enriquecimiento una vez en tiempo de construcción, almacene en caché la capa geo y sirva a coste cero por solicitud.

Alojado en UE, conforme al RGPD

Totalmente alojado en la UE con documentación de cumplimiento RGPD y cláusulas contractuales tipo. Sin riesgo de residencia de datos para portales de anuncios europeos.

Especificaciones técnicas

Endpoint

Método
GET /v1/geoenrich
Formato de respuesta
JSON (schema.org-ready)

Parámetros

address
Obligatorio. Cadena de dirección en bruto.
radius
Metros. Por defecto 600.

Campos de respuesta

coordinates
lat / lng (4 decimales)
nearby[]
nombre, tipo, distancia (metros)

¿Listo para Empezar?

Comienza a construir con MapAtlas hoy. Regístrate gratis y obtén acceso instantáneo a todas nuestras APIs de mapeo con generosos límites de nivel gratuito.

GeoEnrich API: preguntas frecuentes

Todo lo que necesita saber antes de enriquecer su primer anuncio.

GeoEnrich API: preguntas frecuentes

Todo lo que necesita saber antes de enriquecer su primer anuncio.

¿Qué datos devuelve la GeoEnrich API?
Una sola llamada devuelve: coordenadas con precisión de tejado (lat/lng), una jerarquía completa del barrio (sub-barrio, barrio, distrito, ciudad, región, país, código postal) y una lista de lugares cercanos dentro del radio elegido. Cada lugar cercano incluye nombre, tipo, distancia, orientación, tiempos de desplazamiento a pie, en bicicleta y en coche, además de detalles enriquecidos como destinos de líneas de transporte, horarios de apertura, valoraciones y datos de afluencia en directo. La respuesta también incluye un neighborhoodProfile con walkScore, bikeScore, transitScore, índice de calidad del aire y nivel de ruido.
¿Cuál es la diferencia entre la GeoEnrich API y una API de geocodificación?
Una API de geocodificación convierte una dirección en coordenadas. La GeoEnrich API va mucho más allá: combina la geocodificación con la resolución del barrio y una búsqueda completa de POIs en una sola llamada. En lugar de devolver un par lat/lng, devuelve todo lo que una página de anuncio necesita para ser visible para la IA, incluidos campos listos para schema.org para GeoCoordinates, containedInPlace y amenityFeature.
¿Con qué frecuencia se actualizan los datos de localización?
Los datos de POIs, los horarios de transporte, las valoraciones y los horarios de apertura se actualizan en ciclos mensuales. Cada respuesta incluye un campo dataTimestamp para que pueda mostrar la fecha de actualización como dateModified en su JSON-LD. Los motores IA y los robots de búsqueda tratan los datos con marca de tiempo reciente como más fiables, lo que mejora las tasas de cita.
¿Funciona la GeoEnrich API para todos los países?
Sí. La API cubre más de 180 países con salida JSON consistente y el mismo mapeo de campos schema.org en todas partes. La profundidad de cobertura varía según la región: las ciudades europeas tienen los datos de POIs y transporte más detallados, mientras que la cobertura global incluye coordenadas, jerarquía del barrio y categorías principales de POIs.
¿Puedo ejecutar GeoEnrich en una gran base de datos de anuncios?
La API está específicamente diseñada para uso masivo. Ejecute el trabajo de enriquecimiento una vez en tiempo de construcción, almacene en caché la capa geo por anuncio y sirva sin costes recurrentes por solicitud. El nivel gratuito incluye 50.000 enriquecimientos por mes. Los planes más grandes soportan mayor rendimiento con soporte de endpoint por lotes.
¿Cómo ayudan los datos de localización a las páginas de anuncios a posicionarse en la búsqueda IA?
Los motores de búsqueda IA como Perplexity, ChatGPT y Google AI Overviews responden consultas como 'apartamentos cerca del metro en Prenzlauer Berg' leyendo datos estructurados en su HTML. Sin marcado schema.org para GeoCoordinates, containedInPlace y amenityFeature, sus anuncios son invisibles para estos motores, independientemente de su posición en Google. GeoEnrich proporciona exactamente los datos geo necesarios para rellenar ese marcado a escala.
¿La GeoEnrich API cumple con el RGPD?
Sí. Todo el procesamiento ocurre en infraestructura alojada en la UE. Las direcciones y coordenadas no se almacenan más allá del ciclo de vida de la solicitud. MapAtlas proporciona cláusulas contractuales tipo y documentación de cumplimiento RGPD para portales de anuncios europeos y responsables del tratamiento de datos.
¿Puede la GeoEnrich API devolver la ubicación geográfica de una dirección IP?
Sí. Le pasas una dirección IP y GeoEnrich devuelve su ubicación geográfica aproximada, incluidos país, región, ciudad y coordenadas. La geolocalización por IP es útil para centrar el mapa por defecto, generar señales de fraude y localizar el contenido antes de que el usuario comparta una ubicación precisa. Todas las consultas se ejecutan en infraestructura alojada en la UE.
¿Qué precisión tiene la geolocalización por IP frente a las coordenadas GPS?
La geolocalización por IP resuelve a nivel de ciudad o región, no con la precisión a nivel de calle del GPS. Úsala para valores por defecto aproximados y analítica, y recurre a la Geocoding API o al GPS del dispositivo cuando necesites una dirección o un punto exactos. GeoEnrich te permite combinar ambos en una sola llamada de enriquecimiento.