Hướng dẫn xây dựng tính năng phân vùng giao hàng (Delivery Zones) tại Việt Nam bằng Map API

[Địa chỉ Khách nhập] ──> [Geocoding API] ──> [Tọa độ Lat/Lng]
                                                    │
                                                    ▼
[Áp phí Giao hàng] <── [Khớp phân vùng] <── [Kiểm tra Point-in-Polygon]

curl -H "X-API-Key: gdk_live_..." \
  "https://api.gogoduk.com/v1/admin-boundaries/resolve?district=Quan+1&province=Ho+Chi+Minh"

{
  "name": "Quận 1",
  "province": "Thành phố Hồ Chí Minh",
  "geometry": {
    "type": "Polygon",
    "coordinates": [
      [
        [106.6974, 10.7852],
        [106.7041, 10.7811],
        ...
      ]
    ]
  }
}

// Gọi khi người dùng đang gõ
async function getSuggestions(input) {
  const res = await fetch(`https://api.gogoduk.com/v1/suggest?input=${encodeURIComponent(input)}`, {
    headers: { "X-API-Key": "gdk_live_..." }
  });
  const data = await res.json();
  return data.predictions; // Trả về danh sách địa chỉ gợi ý chuẩn
}

async function resolveLocation(placeId) {
  const res = await fetch(`https://api.gogoduk.com/v1/resolve?id=${placeId}`, {
    headers: { "X-API-Key": "gdk_live_..." }
  });
  const data = await res.json();
  const { lat, lon } = data.result.location;
  return [lon, lat]; // Định dạng [lng, lat] dùng cho GeoJSON/Turf.js
}

npm install @turf/boolean-point-in-polygon @turf/helpers

import pointInPolygon from "@turf/boolean-point-in-polygon";
import { point, polygon } from "@turf/helpers";
 
// Tọa độ khách hàng nhận từ GoGoDuk Resolve API
const customerCoordinate = [106.6994, 10.7769]; // Chợ Bến Thành
const customerPoint = point(customerCoordinate);
 
// Ranh giới Quận 1 lấy từ GoGoDuk Admin Boundaries API
const districtBoundaryGeometry = {
  "type": "Polygon",
  "coordinates": [
    [
      [106.6925, 10.7850],
      [106.7080, 10.7800],
      [106.7020, 10.7680],
      [106.6880, 10.7730],
      [106.6925, 10.7850] // Khép kín polygon
    ]
  ]
};
const districtPolygon = polygon(districtBoundaryGeometry.coordinates);
 
// Chạy thuật toán kiểm tra
const isInside = pointInPolygon(customerPoint, districtPolygon);
 
if (isInside) {
  console.log("Khách hàng nằm trong vùng giao hàng của Quận 1!");
  // Áp dụng biểu phí giao hàng của Quận 1 (ví dụ: 15,000 VND)
} else {
  console.log("Địa chỉ nằm ngoài phạm vi phục vụ.");
}

app.post("/api/checkout/shipping-fee", async (req, res) => {
  try {
    const { placeId } = req.body;
    
    // 1. Dịch Place ID thành tọa độ GPS
    const customerLatLng = await resolveLocation(placeId);
    
    // 2. Chạy hàm reverse geocode hoặc ST_Contains trong DB để xem điểm đó
    // thuộc ranh giới của Quận nào. Ở đây chúng ta gọi database để kiểm tra.
    const activeDistricts = await db.query(
      "SELECT id, name, shipping_fee FROM delivery_zones WHERE ST_Contains(geom, ST_SetSRID(ST_Point($1, $2), 4326))",
      [customerLatLng.lng, customerLatLng.lat]
    );
 
    if (activeDistricts.rows.length > 0) {
      const zone = activeDistricts.rows[0];
      return res.json({
        success: true,
        district: zone.name,
        fee: zone.shipping_fee,
      });
    } else {
      return res.json({
        success: false,
        message: "Rất tiếc, địa chỉ của bạn nằm ngoài vùng phục vụ của chúng tôi."
      });
    }
  } catch (error) {
    res.status(500).json({ error: error.message });
  }
});