Skip to main content

API d'enrichissement d'adresses

Géocodage, hiérarchie de quartier et POI à proximité en un seul appel.

Transmettez une adresse. Recevez des coordonnées, la hiérarchie de quartier et les lieux à proximité dans une seule réponse. Tout ce dont vos pages d'annonces ont besoin pour devenir visibles par l'IA, en un seul appel API.

Comment ça fonctionne

Trois étapes pour une annonce entièrement enrichie.

Pas d'assemblage de plusieurs services. Un seul point de terminaison gère géocodage, résolution de quartier et recherche POI en un seul appel.

01

Envoyez l'adresse

Transmettez n'importe quelle chaîne d'adresse brute, un code postal ou une paire de coordonnées à GET /v1/geoenrich. Aucun prétraitement ni normalisation d'adresse requis.

02

MapAtlas résout la couche géo complète

L'API géocode l'adresse à la précision toiture, résout la hiérarchie de quartier et analyse plus d'un milliard de POIs indexés dans votre rayon choisi, retournant notes, lignes de transport, horaires d'ouverture et temps de trajet.

03

Injectez dans votre JSON-LD et publiez

Chaque champ de la réponse correspond directement à une propriété schema.org. Insérez les coordonnées dans GeoCoordinates, le quartier dans containedInPlace et les lieux à proximité dans amenityFeature. Aucune transformation requise.

The API

Un appel. Intelligence de localisation complète.

La plupart des bases de données d'annonces stockent ce que les utilisateurs saisissent : adresse, prix, chambres. Elles n'ont jamais été conçues pour fournir un contexte géographique lisible par les machines. GeoEnrich API comble ce fossé en une seule requête, retournant coordonnées, analyses de quartier, transports en temps réel, notes, temps de trajet et bien plus.

  • Transmettez la chaîne d'adresse brute. Aucun prétraitement requis.
  • Recevez les coordonnées, la hiérarchie complète du quartier et les scores de profil.
  • Obtenez les lieux à proximité avec notes, horaires d'ouverture et données de transport en direct.
  • Chaque champ correspond directement à une propriété 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

Ce qu'un appel retourne

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.

Coordonnées précises

lat/lng à précision toiture avec altitude. Alimente directement le schéma GeoCoordinates.

latlngelevation

Intelligence de quartier

Hiérarchie complète plus walkScore, bikeScore, transitScore, niveau sonore, indice de qualité de l'air et étiquettes de caractère. Alimente containedInPlace et le contexte de quartier.

neighborhooddistrictwalkScorenoiseLevel

Lieux à proximité enrichis

Plus de 1 328 POIs avec notes, horaires d'ouverture, lignes de transport, départs en direct, temps de trajet et données de fréquentation. Alimente le schéma amenityFeature.

nametypedistancerealtimerating
GeoEnrich API

Simple. Prévisible. Un seul point de terminaison.

Pas de configuration complexe. Pas d'assemblage de plusieurs appels. Transmettez une adresse, recevez la couche géo complète nécessaire pour alimenter le balisage schema.org sur chaque page d'annonce.

  • Un seul point de terminaison gère géocodage et recherche POI ensemble
  • Filtres optionnels de rayon et de catégorie pour un contrôle précis
  • La réponse se mappe directement sur JSON-LD sans transformation
  • Exécuter au moment de la construction pour zéro coût récurrent par requête
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"
}
Conçu pour chaque type d'annonce

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.

Locations de vacances

Faites apparaître les pages de location individuelles dans les requêtes IA comme 'villa en bord de mer près de Faro avec restaurants à pied'.

Immobilier

Faites remonter les annonces pour des requêtes comme 'appartements à Prenzlauer Berg proche du métro' sans saisie manuelle de données.

Hôtels

Obtenez des citations IA pour des requêtes comme 'hôtel boutique dans le Marais, à pied des musées'.

Expériences

Soyez cité pour des requêtes comme 'cours de cuisine à Barcelone près du Quartier Gothique'.

Tout dans une seule réponse

Un seul point de terminaison retourne la couche de données géo complète dont vos pages d'annonces ont besoin pour devenir visibles par l'IA.

Coordonnées précises

Précision à quatre décimales. Renseigne le schéma GeoCoordinates sur chaque page d'annonce pour que les moteurs IA puissent la situer géographiquement.

Hiérarchie de quartier

Quartier, arrondissement, ville et pays résolus à partir de l'adresse. Alimente la chaîne containedInPlace pour la récupération IA au niveau de la zone.

Lieux à proximité

Transports, enseignement, loisirs et santé dans un rayon configurable. Chaque lieu est retourné avec distance et temps de marche pour le schéma amenityFeature.

Actualisation mensuelle des données

Chaque réponse inclut un dataTimestamp actualisé chaque mois. Associez-le à dateModified dans votre JSON-LD pour que les moteurs IA voient des données vérifiées et à jour.

Conçu pour le traitement en masse

Conçu pour des bases de données de 50 000 annonces ou plus. Exécutez le traitement d'enrichissement une seule fois au moment de la construction, mettez en cache la couche géo et servez sans coût récurrent par requête.

Hébergé en UE, conforme RGPD

Entièrement hébergé en UE avec documentation de conformité RGPD et clauses contractuelles types. Aucun risque de résidence des données pour les portails d'annonces européens.

Spécifications techniques

Point de terminaison

Méthode
GET /v1/geoenrich
Format de réponse
JSON (schema.org-ready)

Paramètres

address
Obligatoire. Chaîne d'adresse brute.
radius
Mètres. Défaut 600.

Champs de réponse

coordinates
lat / lng (4 décimales)
nearby[]
nom, type, distance (mètres)

Prêt à Commencer ?

Commencez à créer avec MapAtlas dès aujourd'hui. Inscrivez-vous gratuitement et obtenez un accès instantané à toutes nos APIs de cartographie avec des limites de niveau gratuit généreuses.

GeoEnrich API : questions courantes

Tout ce que vous devez savoir avant d'enrichir votre première annonce.

GeoEnrich API : questions courantes

Tout ce que vous devez savoir avant d'enrichir votre première annonce.

Quelles données retourne la GeoEnrich API ?
Un seul appel retourne : des coordonnées à précision toiture (lat/lng), une hiérarchie complète de quartier (sous-quartier, quartier, arrondissement, ville, région, pays, code postal) et une liste de lieux à proximité dans le rayon choisi. Chaque lieu inclut nom, type, distance, orientation, temps de trajet à pied, à vélo et en voiture, plus des détails riches tels que destinations des lignes de transport, horaires d'ouverture, notes et données de fréquentation en direct. La réponse inclut aussi un neighborhoodProfile avec walkScore, bikeScore, transitScore, indice de qualité de l'air et niveau sonore.
Quelle est la différence entre la GeoEnrich API et une API de géocodage ?
Une API de géocodage convertit une adresse en coordonnées. La GeoEnrich API va bien plus loin : elle combine le géocodage avec la résolution de quartier et une recherche POI complète en un seul appel. Au lieu de retourner une paire lat/lng, elle retourne tout ce dont une page d'annonce a besoin pour devenir visible par l'IA, y compris les champs prêts pour schema.org pour GeoCoordinates, containedInPlace et amenityFeature.
À quelle fréquence les données de localisation sont-elles mises à jour ?
Les données POI, les horaires de transport, les notes et les horaires d'ouverture sont actualisés sur un cycle mensuel. Chaque réponse inclut un champ dataTimestamp pour que vous puissiez afficher la date d'actualisation comme dateModified dans votre JSON-LD. Les moteurs IA et les robots d'exploration considèrent les données fraîchement horodatées comme plus fiables, ce qui améliore les taux de citation.
La GeoEnrich API fonctionne-t-elle pour tous les pays ?
Oui. L'API couvre plus de 180 pays avec une sortie JSON cohérente et le même mappage de champs schema.org partout. La profondeur de couverture varie selon la région : les villes européennes ont les données POI et transport les plus détaillées, tandis que la couverture mondiale inclut les coordonnées, la hiérarchie de quartier et les catégories POI principales.
Puis-je exécuter GeoEnrich sur une large base de données d'annonces ?
L'API est spécifiquement conçue pour un usage en masse. Exécutez le traitement d'enrichissement une seule fois au moment de la construction, mettez en cache la couche géo par annonce et servez sans coût récurrent par requête. Le niveau gratuit inclut 50 000 enrichissements par mois. Les plans supérieurs supportent un débit plus élevé avec prise en charge des points de terminaison par lots.
Comment les données de localisation aident-elles les pages d'annonces à se classer dans la recherche IA ?
Les moteurs de recherche IA comme Perplexity, ChatGPT et Google AI Overviews répondent aux requêtes telles que 'appartements près du métro à Prenzlauer Berg' en lisant les données structurées dans votre HTML. Sans balisage schema.org pour GeoCoordinates, containedInPlace et amenityFeature, vos annonces sont invisibles pour ces moteurs, quel que soit leur classement sur Google. GeoEnrich fournit exactement les données géo nécessaires pour remplir ce balisage à grande échelle.
La GeoEnrich API est-elle conforme au RGPD ?
Oui. Tout le traitement s'effectue sur une infrastructure hébergée en UE. Les adresses et coordonnées ne sont pas stockées au-delà du cycle de vie de la requête. MapAtlas fournit des clauses contractuelles types et une documentation de conformité RGPD pour les portails d'annonces européens et les sous-traitants de données.
La GeoEnrich API peut-elle retourner la localisation géographique d'une adresse IP ?
Oui. Fournissez une adresse IP et GeoEnrich retourne sa localisation géographique approximative, avec le pays, la région, la ville et les coordonnées. La géolocalisation par IP est utile pour centrer la carte par défaut, détecter les signaux de fraude et localiser le contenu avant qu'un utilisateur ne partage une position précise. Toutes les recherches s'exécutent sur une infrastructure hébergée dans l'UE.
Quelle est la précision de la géolocalisation par IP comparée aux coordonnées GPS ?
La géolocalisation par IP atteint le niveau de la ville ou de la région, pas la précision au niveau de la rue offerte par le GPS. Utilisez-la pour des valeurs par défaut approximatives et l'analytique, et appuyez-vous sur la Geocoding API ou le GPS de l'appareil lorsque vous avez besoin d'une adresse ou d'un point exact. GeoEnrich vous permet de combiner les deux en un seul appel d'enrichissement.