Skip to main content

주소 보강 API

한 번의 호출로 지오코딩, 동네 계층 구조, 주변 장소까지.

주소를 입력하면 단일 응답으로 좌표, 동네 계층 구조, 주변 장소를 받습니다. 매물 페이지를 AI 가시화하는 데 필요한 모든 것을 한 번의 API 호출로 제공합니다.

작동 방식

세 단계로 완전히 에리치된 매물.

여러 서비스를 조합할 필요가 없습니다. 하나의 엔드포인트가 단일 호출로 지오코딩, 동네 해석, POI 조회를 처리합니다.

01

주소 전송

임의의 원시 주소 문자열, 우편번호, 또는 좌표 쌍을 GET /v1/geoenrich에 입력합니다. 전처리나 주소 정규화가 필요하지 않습니다.

02

MapAtlas가 완전한 지리 레이어를 해석합니다

API는 주소를 지붕 수준 정확도로 지오코딩하고, 동네 계층 구조를 해석하며, 선택한 반경 내 10억 개 이상의 인덱스된 POI를 스캔하여 평점, 대중교통 노선, 영업시간, 이동 시간을 반환합니다.

03

JSON-LD에 삽입하고 제공

응답의 모든 필드가 schema.org 속성에 직접 매핑됩니다. 좌표를 GeoCoordinates에, 동네를 containedInPlace에, 주변 장소를 amenityFeature에 넣기만 하면 됩니다. 변환이 필요하지 않습니다.

The API

한 번의 호출로 완전한 위치 인텔리전스를.

대부분의 매물 데이터베이스는 사람이 입력한 내용을 저장합니다: 주소, 가격, 침실 수. 기계 가독 지리적 컨텍스트를 제공하도록 설계되지 않았습니다. GeoEnrich API는 좌표, 동네 분석, 실시간 대중교통, 평점, 이동 시간 등을 단일 요청으로 반환하여 이 격차를 해소합니다.

  • 원시 주소 문자열을 그대로 입력하세요. 전처리 불필요.
  • 좌표, 완전한 동네 계층 구조, 프로필 점수를 받습니다.
  • 평점, 영업시간, 실시간 대중교통 데이터가 포함된 주변 장소를 받습니다.
  • 모든 필드가 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

한 번의 호출이 반환하는 것

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.

정밀한 좌표

고도를 포함한 지붕 수준 정확도의 lat/lng. GeoCoordinates 스키마에 직접 적용됩니다.

latlngelevation

동네 인텔리전스

walkScore, bikeScore, transitScore, 소음 수준, 대기질 지수, 특성 태그를 포함한 완전한 계층 구조. containedInPlace와 동네 컨텍스트를 구성합니다.

neighborhooddistrictwalkScorenoiseLevel

풍부한 주변 장소

평점, 영업시간, 대중교통 노선, 실시간 출발 정보, 이동 시간, 혼잡도 데이터를 포함한 1,328개 이상의 POI. amenityFeature 스키마를 구성합니다.

nametypedistancerealtimerating
GeoEnrich API

간단하고 예측 가능하며 단일 엔드포인트.

복잡한 설정 불필요. 여러 호출을 조합할 필요도 없습니다. 주소를 입력하면 각 매물 페이지의 schema.org 마크업에 필요한 완전한 지리 레이어가 반환됩니다.

  • 단일 엔드포인트가 지오코딩과 POI 조회를 함께 처리
  • 정밀한 제어를 위한 선택적 반경 및 카테고리 필터
  • 응답이 변환 없이 JSON-LD에 직접 매핑
  • 빌드 시 실행으로 지속적인 요청당 비용 제로
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"
}
모든 매물 유형에 적합

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.

휴가 임대

개별 임대 페이지가 "파루 해변 근처 레스토랑까지 도보 거리의 빌라" 같은 AI 쿼리에 표시되게 합니다.

부동산

수동 데이터 입력 없이 "프렌츨라우어 베르크의 지하철 근처 아파트" 같은 쿼리에 매물이 표시됩니다.

호텔

"마레 지구의 부티크 호텔, 박물관까지 도보 거리" 같은 AI 인용을 확보합니다.

체험 활동

"바르셀로나 고딕 지구 근처 요리 교실" 같은 쿼리에 인용됩니다.

단일 응답에 모든 것이

하나의 엔드포인트가 매물 페이지를 AI 가시화하는 데 필요한 완전한 지리 데이터 레이어를 반환합니다.

정밀한 좌표

소수점 네 자리 정확도. 모든 매물 페이지에 GeoCoordinates 스키마를 채워 AI 엔진이 지리적 위치를 파악할 수 있게 합니다.

동네 계층 구조

주소에서 동네, 구, 시, 국가를 해석합니다. 지역 수준 AI 검색을 위한 containedInPlace 체인을 구성합니다.

주변 장소

설정 가능한 반경 내의 교통, 교육, 레저, 의료 시설. 각 장소는 amenityFeature 스키마를 위한 거리와 도보 시간이 포함됩니다.

월간 데이터 갱신

모든 응답에는 매월 업데이트되는 dataTimestamp가 포함됩니다. JSON-LD의 dateModified에 매핑하면 AI 엔진이 검증된 최신 데이터를 확인합니다.

대량 처리 지원

50,000개 이상의 매물 데이터베이스를 위해 설계되었습니다. 빌드 시 한 번 에리치먼트 작업을 실행하고, 지리 레이어를 캐싱하여 요청당 비용 없이 제공합니다.

EU 호스팅, GDPR 준수

완전히 EU에서 호스팅되며 GDPR 준수 문서와 표준 계약 조항을 제공합니다. 유럽 매물 포털은 데이터 보관 위험이 없습니다.

기술 사양

엔드포인트

메서드
GET /v1/geoenrich
응답 형식
JSON (schema.org-ready)

파라미터

address
필수. 원시 주소 문자열.
radius
미터. 기본값 600.

응답 필드

coordinates
lat / lng (소수점 4자리)
nearby[]
이름, 유형, 거리 (미터)

시작할 준비가 되셨나요?

오늘 MapAtlas로 구축을 시작하세요. 무료로 가입하고 넉넉한 무료 티어 한도로 모든 매핑 API에 즉시 액세스하세요.

GeoEnrich API: 자주 묻는 질문

첫 번째 매물을 에리치하기 전에 알아야 할 모든 것.

GeoEnrich API: 자주 묻는 질문

첫 번째 매물을 에리치하기 전에 알아야 할 모든 것.

GeoEnrich API는 어떤 데이터를 반환합니까?
단일 호출로 지붕 수준 정확도 좌표(lat/lng), 완전한 동네 계층 구조(소구, 동네, 구, 시, 도, 국가, 우편번호), 선택한 반경 내 주변 장소 목록이 반환됩니다. 각 주변 장소에는 이름, 유형, 거리, 방위, 도보/자전거/자동차 이동 시간과 함께 대중교통 노선 목적지, 영업시간, 평점, 실시간 혼잡도 데이터 같은 상세 정보가 포함됩니다. walkScore, bikeScore, transitScore, 대기질 지수, 소음 수준을 포함한 neighborhoodProfile도 반환됩니다.
GeoEnrich API와 지오코딩 API의 차이는 무엇입니까?
지오코딩 API는 주소를 좌표로 변환합니다. GeoEnrich API는 훨씬 더 나아갑니다: 단일 호출로 지오코딩, 동네 해석, 완전한 POI 검색을 결합합니다. lat/lng 쌍만 반환하는 대신, 매물 페이지를 AI 가시화하는 데 필요한 모든 것, 즉 GeoCoordinates, containedInPlace, amenityFeature를 위한 schema.org 준비 필드를 반환합니다.
위치 데이터는 얼마나 자주 업데이트됩니까?
POI 데이터, 대중교통 시간표, 평점, 영업시간은 월간 주기로 갱신됩니다. 모든 응답에 dataTimestamp 필드가 포함되어 JSON-LD에서 갱신 날짜를 dateModified로 표시할 수 있습니다. AI 엔진과 검색 크롤러는 새 타임스탬프가 있는 데이터를 더 신뢰할 수 있다고 평가하여 인용률이 향상됩니다.
GeoEnrich API는 모든 국가에서 작동합니까?
네. API는 180개 이상의 국가를 커버하며 일관된 JSON 출력과 동일한 schema.org 필드 매핑을 제공합니다. 커버리지 깊이는 지역에 따라 다릅니다: 유럽 도시는 가장 상세한 POI 및 대중교통 데이터를 보유하며, 글로벌 커버리지에는 좌표, 동네 계층 구조, 주요 POI 카테고리가 포함됩니다.
대규모 매물 데이터베이스에서 GeoEnrich를 실행할 수 있습니까?
API는 특히 대량 사용을 위해 구축되었습니다. 빌드 시 한 번 에리치먼트 작업을 실행하고, 매물별로 지리 레이어를 캐싱하여 지속적인 요청당 비용 없이 제공합니다. 무료 플랜에는 월 50,000 에리치먼트가 포함됩니다. 더 큰 플랜은 배치 엔드포인트 지원으로 더 높은 처리량을 지원합니다.
위치 데이터가 AI 검색에서 매물 페이지 순위를 높이는 데 어떻게 도움이 됩니까?
Perplexity, ChatGPT, Google AI Overviews 같은 AI 검색 엔진은 HTML의 구조화된 데이터를 읽어 "프렌츨라우어 베르크의 지하철 근처 아파트" 같은 쿼리에 답합니다. GeoCoordinates, containedInPlace, amenityFeature에 대한 schema.org 마크업이 없으면 매물은 이런 엔진에 보이지 않습니다. GeoEnrich는 대규모로 해당 마크업을 채우는 데 필요한 정확한 지리 데이터를 제공합니다.
GeoEnrich API는 GDPR을 준수합니까?
네. 모든 처리는 EU 호스팅 인프라에서 이루어집니다. 주소와 좌표는 요청 수명 주기 이후에 저장되지 않습니다. MapAtlas는 유럽 매물 포털 및 데이터 처리자를 위한 표준 계약 조항과 GDPR 준수 문서를 제공합니다.
GeoEnrich API는 IP 주소의 지리적 위치를 반환할 수 있습니까?
네. IP 주소를 전달하면 GeoEnrich가 국가, 지역, 시, 좌표를 포함한 대략적인 지리적 위치를 반환합니다. IP 기반 위치 측정은 지도 기본 중심점 설정, 이상 거래 탐지 신호, 사용자가 정확한 위치를 공유하기 전 콘텐츠 현지화에 유용합니다. 모든 조회는 EU 기반 인프라에서 처리됩니다.
IP 기반 위치 측정은 GPS 좌표에 비해 얼마나 정확합니까?
IP 기반 위치 측정은 GPS의 도로 수준 정밀도가 아니라 시 또는 지역 수준까지만 해석됩니다. 대략적인 기본값과 분석 용도로는 IP를 사용하고, 정확한 주소나 지점이 필요할 때는 지오코딩 API나 기기 GPS를 사용하세요. GeoEnrich를 사용하면 단일 보강(enrichment) 호출로 두 가지를 함께 결합할 수 있습니다.