คู่มือการใช้งาน Thailand Geo API ฉบับสมบูรณ์

เจาะลึกทุก Endpoints ของระบบฐานข้อมูลภูมิศาสตร์ประเทศไทย (Provinces, Districts, Sub-Districts, Villages, Hospitals, Zip Codes)

📂 1. การดึงข้อมูลตามลำดับชั้น (Administrative Hierarchy)

GET

/api/v1/geo/provinces

ดึงข้อมูล 77 จังหวัดทั้งหมด รองรับ ?region= เพื่อกรองตามภาค รองรับ ?with_geom=true สำหรับแผนที่

GET

/api/v1/geo/provinces/{pcode}/districts

ดึงรายชื่อ "อำเภอ" ทั้งหมดที่อยู่ภายใต้รหัสจังหวัด (pcode) ที่ระบุ

GET

/api/v1/geo/districts/{pcode}/sub-districts

ดึงรายชื่อ "ตำบล" ทั้งหมดที่อยู่ภายใต้รหัสอำเภอ (pcode) ที่ระบุ

GET

/api/v1/geo/sub-districts/{pcode}/villages (ใหม่ล่าสุด ✨)

ดึงรายชื่อ "หมู่บ้าน" ทั้งหมดที่อยู่ภายในตำบลนั้น ใช้สำหรับทำระบบลงทะเบียนที่อยู่ระดับหมู่บ้าน

🏥 2. จุดสนใจเฉพาะ (POI & Special Zones)

GET

/api/v1/geo/hospitals

ข้อมูลอ้างอิงโรงพยาบาลในกรุงเทพฯ 121 แห่ง กรองได้ด้วย ?province_pcode=, ?district_pcode= หรือ ?sub_district_pcode= ชุดนี้ไม่ใช่ทะเบียนโรงพยาบาลทั่วประเทศและมีสถานะ legacy_unverified

GET

/api/v1/geo/postal-codes/{zip}

ค้นหาที่อยู่ (รายชื่อตำบล/อำเภอ/จังหวัด) จากรหัสไปรษณีย์ 5 หลัก

GET

/api/v1/geo/special-admin-zones/{code}

ดึงข้อมูลเขตปกครองพิเศษ (Bangkok หรือ Pattaya City)

🔍 3. การค้นหาและการแปลงพิกัด (Search & Spatial)

GET

/api/v1/geo/search

ค้นหาชื่อ (Trigram fuzzy search) จาก จังหวัด, อำเภอ, ตำบล พร้อมจัดเรียงตามความแม่นยำ

GET

/api/v1/geo/reverse

แปลงพิกัด (?lat=...&lng=...) เป็น ลำดับชั้นที่รับผิดชอบ (จังหวัด, อำเภอ, ตำบล ที่จุดนั้นครอบอยู่)

GET

/api/v1/geo/within

ค้นหาพื้นที่ที่จุดกึ่งกลาง (Centroid) อยู่ในรัศมีวงกลมที่กำหนดโดย lat, lng, radius_km

GET

/api/v1/geo/tiles/{level}/{z}/{x}/{y}.mvt

ระบบ Vector Tiles สำหรับ Frontend Map (Box) นำไป Render แผนที่แบบ High-performance