Skip to main content

API de enriquecimento de endereços

Geocodificação, hierarquia de bairros e POIs próximos em uma única chamada.

Envie um endereço. Receba coordenadas, hierarquia de bairro e locais próximos numa única resposta. Tudo o que as suas páginas de listagem precisam para se tornarem visíveis para a IA, numa só chamada API.

Como funciona

Três passos para uma listagem completamente enriquecida.

Sem juntar múltiplos serviços. Um endpoint trata geocodificação, resolução de bairro e pesquisa de POI numa única chamada.

01

Envie o endereço

Passe qualquer cadeia de endereço em bruto, um código postal ou um par de coordenadas para GET /v1/geoenrich. Não é necessário pré-processamento nem normalização de endereço.

02

MapAtlas resolve a camada geo completa

A API geocodifica o endereço com precisão ao telhado, resolve a hierarquia do bairro e analisa mais de mil milhões de POIs indexados dentro do raio escolhido, devolvendo avaliações, linhas de transporte, horários de funcionamento e tempos de viagem.

03

Injete no JSON-LD e publique

Cada campo na resposta mapeia diretamente para uma propriedade schema.org. Insira as coordenadas em GeoCoordinates, o bairro em containedInPlace e os locais próximos em amenityFeature. Não é necessária transformação.

The API

Uma chamada. Inteligência de localização completa.

A maioria das bases de dados de listagens armazena o que os utilizadores introduzem: endereço, preço, quartos. Nunca foram concebidas para fornecer contexto geográfico legível por máquinas. A GeoEnrich API preenche essa lacuna num único pedido, devolvendo coordenadas, análises de bairro, transportes em tempo real, avaliações, tempos de viagem e muito mais.

  • Envie a cadeia de endereço em bruto. Não é necessário pré-processamento.
  • Receba coordenadas, hierarquia completa do bairro e pontuações de perfil.
  • Obtenha locais próximos com avaliações, horários de funcionamento e dados de transporte em direto.
  • Cada campo mapeia diretamente para uma propriedade 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

O que uma chamada devolve

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 com precisão ao telhado e altitude. Alimenta diretamente o esquema GeoCoordinates.

latlngelevation

Inteligência de bairro

Hierarquia completa mais walkScore, bikeScore, transitScore, nível de ruído, índice de qualidade do ar e etiquetas de caráter. Alimenta containedInPlace e o contexto do bairro.

neighborhooddistrictwalkScorenoiseLevel

Locais próximos enriquecidos

Mais de 1.328 POIs com avaliações, horários de funcionamento, linhas de transporte, partidas em direto, tempos de viagem e dados de afluência. Alimenta o esquema amenityFeature.

nametypedistancerealtimerating
GeoEnrich API

Simples. Previsível. Um endpoint.

Sem configuração complexa. Sem juntar múltiplas chamadas. Envie um endereço, receba a camada geo completa necessária para alimentar a marcação schema.org em cada página de listagem.

  • Um único endpoint trata geocodificação e pesquisa de POI em conjunto
  • Filtros opcionais de raio e categoria para controlo preciso
  • A resposta mapeia diretamente para JSON-LD sem transformação
  • Execute em tempo de construção para zero custos recorrentes por pedido
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"
}
Construído para cada tipo de listagem

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.

Alojamento local e turismo

Faça com que as páginas de aluguer individuais apareçam em consultas IA como 'moradia à beira-mar perto de Faro com restaurantes a pé'.

Imobiliário

Mostre listagens para consultas como 'apartamentos em Prenzlauer Berg perto do metro' sem introdução manual de dados.

Hotéis

Ganhe citações IA para consultas como 'hotel boutique no Marais, a pé dos museus'.

Experiências

Seja citado para consultas como 'aula de culinária em Barcelona perto do Bairro Gótico'.

Tudo numa resposta

Um único endpoint devolve a camada de dados geo completa de que as suas páginas de listagem precisam para se tornarem visíveis para a IA.

Coordenadas precisas

Precisão de quatro casas decimais. Preenche o esquema GeoCoordinates em cada página de listagem para que os motores de IA possam situá-la no espaço geográfico.

Hierarquia de bairro

Bairro, distrito, cidade e país resolvidos a partir do endereço. Alimenta a cadeia containedInPlace para recuperação IA ao nível de área.

Locais próximos

Transportes, ensino, lazer e saúde dentro de um raio configurável. Cada local é devolvido com distância e tempo a pé para o esquema amenityFeature.

Atualização mensal de dados

Cada resposta inclui um dataTimestamp atualizado mensalmente. Associe-o ao dateModified no seu JSON-LD para que os motores IA vejam dados verificados e atualizados.

Construído para processamento em massa

Concebido para bases de dados com 50.000 listagens ou mais. Execute o trabalho de enriquecimento uma vez em tempo de construção, coloque em cache a camada geo e sirva sem custo recorrente por pedido.

Alojado na UE, conforme com o RGPD

Totalmente alojado na UE com documentação de conformidade RGPD e cláusulas contratuais tipo. Sem risco de residência de dados para portais de listagem europeus.

Especificações técnicas

Endpoint

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

Parâmetros

address
Obrigatório. Cadeia de endereço em bruto.
radius
Metros. Predefinição 600.

Campos de resposta

coordinates
lat / lng (4 casas decimais)
nearby[]
nome, tipo, distância (metros)

Pronto para Começar?

Comece a construir com MapAtlas hoje. Cadastre-se gratuitamente e obtenha acesso instantâneo a todas as nossas APIs de mapeamento com limites generosos no nível gratuito.

GeoEnrich API: perguntas frequentes

Tudo o que precisa de saber antes de enriquecer a sua primeira listagem.

GeoEnrich API: perguntas frequentes

Tudo o que precisa de saber antes de enriquecer a sua primeira listagem.

Que dados devolve a GeoEnrich API?
Uma única chamada devolve: coordenadas com precisão ao telhado (lat/lng), uma hierarquia completa do bairro (sub-bairro, bairro, distrito, cidade, região, país, código postal) e uma lista de locais próximos dentro do raio escolhido. Cada local próximo inclui nome, tipo, distância, orientação, tempos de viagem a pé, de bicicleta e de carro, além de detalhes enriquecidos como destinos de linhas de transporte, horários de funcionamento, avaliações e dados de afluência em direto. A resposta inclui também um neighborhoodProfile com walkScore, bikeScore, transitScore, índice de qualidade do ar e nível de ruído.
Qual é a diferença entre a GeoEnrich API e uma API de geocodificação?
Uma API de geocodificação converte um endereço em coordenadas. A GeoEnrich API vai muito mais além: combina geocodificação com resolução de bairro e uma pesquisa completa de POIs numa única chamada. Em vez de devolver um par lat/lng, devolve tudo o que uma página de listagem precisa para se tornar visível para a IA, incluindo campos prontos para schema.org para GeoCoordinates, containedInPlace e amenityFeature.
Com que frequência são atualizados os dados de localização?
Os dados de POIs, os horários de transporte, as avaliações e os horários de funcionamento são atualizados em ciclos mensais. Cada resposta inclui um campo dataTimestamp para mostrar a data de atualização como dateModified no seu JSON-LD. Os motores IA e os robots de pesquisa tratam dados com marca temporal recente como mais fiáveis, o que melhora as taxas de citação.
A GeoEnrich API funciona para todos os países?
Sim. A API cobre mais de 180 países com saída JSON consistente e o mesmo mapeamento de campos schema.org em todo o lado. A profundidade de cobertura varia por região: as cidades europeias têm os dados de POIs e transportes mais detalhados, enquanto a cobertura global inclui coordenadas, hierarquia de bairro e categorias principais de POIs.
Posso executar a GeoEnrich numa grande base de dados de listagens?
A API é especificamente construída para uso em massa. Execute o trabalho de enriquecimento uma vez em tempo de construção, coloque em cache a camada geo por listagem e sirva sem custos recorrentes por pedido. O nível gratuito inclui 50.000 enriquecimentos por mês. Os planos maiores suportam maior débito com suporte a endpoint de lote.
Como é que os dados de localização ajudam as páginas de listagem a posicionar-se na pesquisa IA?
Os motores de pesquisa IA como Perplexity, ChatGPT e Google AI Overviews respondem a consultas como 'apartamentos perto do metro em Prenzlauer Berg' lendo dados estruturados no seu HTML. Sem marcação schema.org para GeoCoordinates, containedInPlace e amenityFeature, as suas listagens são invisíveis para estes motores, independentemente do seu posicionamento no Google. A GeoEnrich fornece exatamente os dados geo necessários para preencher essa marcação em escala.
A GeoEnrich API é conforme com o RGPD?
Sim. Todo o processamento ocorre em infraestrutura alojada na UE. Endereços e coordenadas não são armazenados para além do ciclo de vida do pedido. A MapAtlas fornece cláusulas contratuais tipo e documentação de conformidade RGPD para portais de listagem europeus e subcontratantes de dados.
A GeoEnrich API consegue retornar a localização geográfica de um endereço IP?
Sim. Passe um endereço IP e a GeoEnrich retorna sua localização geográfica aproximada, incluindo país, região, cidade e coordenadas. A geolocalização por IP é útil para centralizar o mapa por padrão, gerar sinais de fraude e localizar conteúdo antes que o usuário compartilhe uma localização precisa. Todas as consultas rodam em infraestrutura hospedada na UE.
Qual a precisão da geolocalização por IP em comparação com coordenadas de GPS?
A geolocalização por IP resolve no nível de cidade ou região, não na precisão de rua do GPS. Use-a para padrões aproximados e analytics, e recorra à Geocoding API ou ao GPS do dispositivo quando precisar de um endereço ou ponto exato. A GeoEnrich permite combinar as duas abordagens em uma única chamada de enriquecimento.