Skip to main content

API làm giàu địa chỉ

Geocoding, phân cấp khu vực và POI gần đó trong một lần gọi.

Nhập địa chỉ. Nhận tọa độ, phân cấp khu vực và địa điểm lân cận trong một phản hồi duy nhất. Tất cả những gì trang danh sách của bạn cần để hiển thị với AI, trong một lần gọi API.

Cách hoạt động

Ba bước để có danh sách được làm giàu hoàn toàn.

Không cần kết nối nhiều dịch vụ. Một endpoint xử lý geocoding, phân giải khu phố và tra cứu POI trong một lần gọi.

01

Gửi địa chỉ từng danh sách đến GeoEnrich API

Nhập chuỗi địa chỉ hiện có của bạn trong một công việc batch. API geocode từng địa chỉ đến độ chính xác mái nhà, phân giải phân cấp khu phố đầy đủ, quét hơn 1 tỷ POI được lập chỉ mục trong bán kính bạn chọn và trả về phân tích khu phố bao gồm walkScore và điểm giao thông.

02

Nhận lớp địa lý hoàn chỉnh mỗi danh sách

Mỗi phản hồi chứa tọa độ, khu phố, quận, thành phố, quốc gia, địa điểm lân cận kèm đánh giá và thời gian di chuyển, cùng dấu thời gian hàng tháng đã được xác minh. Không cần kết nối nhiều dịch vụ. Một lần gọi trả về tất cả những gì cần thiết để làm cho danh sách đó hiển thị với AI.

03

Chèn JSON-LD vào từng trang danh sách

Ánh xạ phản hồi vào các thuộc tính schema.org và nhúng dưới dạng khối JSON-LD. Mỗi trường ánh xạ trực tiếp vào GeoCoordinates, containedInPlace hoặc amenityFeature. Không cần biến đổi. Mỗi trang danh sách trở thành một thực thể địa lý có thể phân giải mà các công cụ AI có thể tìm thấy, xếp hạng và trích dẫn.

The API

Một lần gọi. Thông tin vị trí hoàn chỉnh.

Hầu hết cơ sở dữ liệu danh sách lưu trữ những gì con người nhập: địa chỉ, giá cả, số phòng ngủ. Chúng không bao giờ được thiết kế để cung cấp bối cảnh địa lý có thể đọc được bởi máy. GeoEnrich API lấp đầy khoảng trống đó trong một yêu cầu duy nhất, trả về tọa độ, phân tích khu phố, giao thông công cộng thời gian thực, đánh giá, thời gian di chuyển và nhiều hơn nữa.

  • Nhập chuỗi địa chỉ thô. Không cần tiền xử lý.
  • Nhận tọa độ, phân cấp khu phố đầy đủ và điểm hồ sơ.
  • Nhận các địa điểm lân cận kèm đánh giá, giờ mở cửa và dữ liệu giao thông trực tiếp.
  • Mỗi trường ánh xạ trực tiếp vào thuộc tính 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

Một lần gọi trả về gì

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.

Tọa độ Chính xác

lat/lng chính xác mái nhà kèm độ cao. Trực tiếp hỗ trợ lược đồ GeoCoordinates.

latlngelevation

Thông tin Khu phố

Phân cấp đầy đủ cộng với walkScore, bikeScore, transitScore, mức độ ồn, chỉ số chất lượng không khí và thẻ đặc trưng. Hỗ trợ containedInPlace và bối cảnh khu phố.

neighborhooddistrictwalkScorenoiseLevel

Địa điểm Lân cận Phong phú

Hơn 1.328 POI kèm đánh giá, giờ mở cửa, tuyến giao thông, giờ khởi hành trực tiếp, thời gian di chuyển và dữ liệu mức độ bận rộn. Hỗ trợ lược đồ amenityFeature.

nametypedistancerealtimerating
GeoEnrich API

Đơn giản. Có thể dự đoán. Một endpoint.

Không cần thiết lập phức tạp. Không cần kết nối nhiều lần gọi. Nhập địa chỉ, nhận lớp địa lý hoàn chỉnh cần thiết để hỗ trợ đánh dấu schema.org trên mỗi trang danh sách.

  • Một endpoint xử lý geocoding và tra cứu POI cùng nhau
  • Bộ lọc bán kính và danh mục tùy chọn để kiểm soát chính xác
  • Phản hồi ánh xạ trực tiếp vào JSON-LD không cần biến đổi
  • Chạy vào thời điểm build để đạt chi phí mỗi yêu cầu liên tục bằng không
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"
}
Phù hợp với mọi loại danh sách

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.

Cho thuê Nghỉ dưỡng

Làm cho các trang cho thuê riêng lẻ xuất hiện trong các truy vấn AI như "biệt thự ven biển gần Faro có nhà hàng đi bộ được".

Bất động sản

Hiển thị danh sách cho các truy vấn như "căn hộ ở Prenzlauer Berg gần tàu điện ngầm" mà không cần nhập dữ liệu thủ công.

Khách sạn

Giành được trích dẫn AI cho các truy vấn như "khách sạn boutique ở Marais, đi bộ đến bảo tàng".

Trải nghiệm

Được trích dẫn cho các truy vấn như "lớp học nấu ăn ở Barcelona gần Khu Gothic".

Mọi thứ trong Một Phản hồi

Một endpoint trả về lớp dữ liệu địa lý hoàn chỉnh mà trang danh sách của bạn cần để hiển thị với AI.

Tọa độ Chính xác

Độ chính xác bốn chữ số thập phân. Điền vào lược đồ GeoCoordinates trên mỗi trang danh sách để các công cụ AI có thể định vị trong không gian địa lý.

Phân cấp Khu phố

Khu phố, quận, thành phố và quốc gia được xác định từ địa chỉ. Hỗ trợ chuỗi containedInPlace cho việc truy xuất AI ở cấp độ khu vực.

Địa điểm Lân cận

Giao thông, giáo dục, giải trí và chăm sóc sức khỏe trong bán kính có thể cấu hình. Mỗi địa điểm được trả về kèm khoảng cách và thời gian đi bộ cho lược đồ amenityFeature.

Làm mới Dữ liệu Hàng tháng

Mỗi phản hồi bao gồm dataTimestamp được cập nhật hàng tháng. Ánh xạ nó vào dateModified trong JSON-LD để các công cụ AI thấy dữ liệu được xác minh, cập nhật.

Được Xây dựng cho Xử lý Hàng loạt

Được thiết kế cho cơ sở dữ liệu với 50.000 danh sách trở lên. Chạy công việc làm giàu một lần vào thời điểm build, lưu vào cache lớp địa lý và phục vụ với chi phí mỗi yêu cầu bằng không.

Lưu trữ tại EU, Tuân thủ GDPR

Được lưu trữ hoàn toàn tại EU với tài liệu tuân thủ GDPR và điều khoản hợp đồng tiêu chuẩn. Không có rủi ro lưu trú dữ liệu cho các cổng danh sách châu Âu.

Thông số Kỹ thuật

Endpoint

Phương thức
GET /v1/geoenrich
Định dạng Phản hồi
JSON (schema.org-ready)

Tham số

address
Bắt buộc. Chuỗi địa chỉ thô.
radius
Mét. Mặc định 600.

Trường Phản hồi

coordinates
lat / lng (4 chữ số thập phân)
nearby[]
tên, loại, khoảng cách (mét)

Sẵn Sàng Bắt Đầu?

Bắt đầu xây dựng với MapAtlas ngay hôm nay. Đăng ký miễn phí và nhận quyền truy cập ngay lập tức vào tất cả các API bản đồ của chúng tôi với giới hạn cấp miễn phí hào phóng.

GeoEnrich API: câu hỏi thường gặp

Tất cả những gì bạn cần biết trước khi làm giàu danh sách đầu tiên.

GeoEnrich API: câu hỏi thường gặp

Tất cả những gì bạn cần biết trước khi làm giàu danh sách đầu tiên.

GeoEnrich API trả về dữ liệu gì?
Một lần gọi trả về: tọa độ chính xác mái nhà (lat/lng), phân cấp khu phố đầy đủ (tiểu khu, khu phố, quận, thành phố, tỉnh, quốc gia, mã bưu chính), và danh sách các địa điểm lân cận trong bán kính bạn chọn. Mỗi địa điểm lân cận bao gồm tên, loại, khoảng cách, hướng, thời gian di chuyển bằng đi bộ, xe đạp và ô tô, cộng với thông tin chi tiết như điểm đến tuyến giao thông, giờ mở cửa, đánh giá và dữ liệu mức độ bận rộn trực tiếp. Phản hồi cũng bao gồm neighborhoodProfile với walkScore, bikeScore, transitScore, chỉ số chất lượng không khí và mức độ ồn.
Sự khác biệt giữa GeoEnrich API và API Geocoding là gì?
API Geocoding chuyển đổi địa chỉ thành tọa độ. GeoEnrich API đi xa hơn nhiều: nó kết hợp geocoding với phân giải khu phố và tìm kiếm POI đầy đủ trong một lần gọi. Thay vì chỉ trả về cặp lat/lng, nó trả về mọi thứ trang danh sách cần để hiển thị với AI, bao gồm các trường sẵn sàng schema.org cho GeoCoordinates, containedInPlace và amenityFeature.
Dữ liệu vị trí được cập nhật bao lâu một lần?
Dữ liệu POI, lịch giao thông, đánh giá và giờ mở cửa được làm mới theo chu kỳ hàng tháng. Mỗi phản hồi bao gồm trường dataTimestamp để bạn có thể hiển thị ngày làm mới như dateModified trong JSON-LD. Các công cụ AI và trình thu thập tìm kiếm coi dữ liệu có dấu thời gian mới là đáng tin cậy hơn, cải thiện tỷ lệ trích dẫn.
GeoEnrich API có hoạt động cho tất cả các quốc gia không?
Có. API bao phủ hơn 180 quốc gia với đầu ra JSON nhất quán và cùng một ánh xạ trường schema.org ở mọi nơi. Độ sâu phủ sóng thay đổi theo khu vực: các thành phố châu Âu có dữ liệu POI và giao thông chi tiết nhất, trong khi phủ sóng toàn cầu bao gồm tọa độ, phân cấp khu phố và các danh mục POI chính.
Tôi có thể chạy GeoEnrich trên cơ sở dữ liệu danh sách lớn không?
API được xây dựng đặc biệt cho việc sử dụng hàng loạt. Chạy công việc làm giàu một lần vào thời điểm build, lưu vào cache lớp địa lý mỗi danh sách và phục vụ với chi phí mỗi yêu cầu liên tục bằng không. Gói miễn phí bao gồm 50.000 lần làm giàu mỗi tháng. Các gói lớn hơn hỗ trợ thông lượng cao hơn với hỗ trợ endpoint batch.
Dữ liệu vị trí giúp trang danh sách xếp hạng trong tìm kiếm AI như thế nào?
Các công cụ tìm kiếm AI như Perplexity, ChatGPT và Google AI Overviews trả lời các truy vấn như "căn hộ gần tàu điện ngầm ở Prenzlauer Berg" bằng cách đọc dữ liệu có cấu trúc trong HTML của bạn. Không có đánh dấu schema.org cho GeoCoordinates, containedInPlace và amenityFeature, danh sách của bạn sẽ vô hình với các công cụ này. GeoEnrich cung cấp dữ liệu địa lý chính xác cần thiết để điền vào đánh dấu đó ở quy mô lớn.
GeoEnrich API có tuân thủ GDPR không?
Có. Tất cả quá trình xử lý xảy ra trên cơ sở hạ tầng lưu trữ tại EU. Địa chỉ và tọa độ không được lưu trữ ngoài vòng đời yêu cầu. MapAtlas cung cấp điều khoản hợp đồng tiêu chuẩn và tài liệu tuân thủ GDPR cho các cổng danh sách châu Âu và bộ xử lý dữ liệu.
GeoEnrich API có trả về vị trí địa lý của một địa chỉ IP không?
Có. Bạn truyền vào một địa chỉ IP và GeoEnrich trả về vị trí địa lý gần đúng của nó, bao gồm quốc gia, vùng, thành phố và tọa độ. Định vị địa lý qua IP (IP geolocation) hữu ích để căn giữa bản đồ mặc định, phát hiện tín hiệu gian lận và bản địa hóa nội dung trước khi người dùng chia sẻ vị trí chính xác. Tất cả truy vấn đều chạy trên cơ sở hạ tầng lưu trữ tại EU.
Định vị qua IP chính xác đến mức nào so với tọa độ GPS?
Định vị qua IP (IP geolocation) chỉ phân giải tới cấp thành phố hoặc vùng, không đạt độ chính xác cấp đường phố như GPS. Hãy dùng nó cho giá trị mặc định ở mức thô và cho phân tích, còn khi cần địa chỉ hay điểm chính xác thì dùng Geocoding API hoặc GPS của thiết bị. GeoEnrich cho phép bạn kết hợp cả hai trong cùng một lần gọi làm giàu dữ liệu.