คู่มือ API ระบบบริการฐานข้อมูลสารสนเทศภูมิศาสตร์ (GIS) เพื่อการเกษตร

เริ่มต้นใช้งาน API

เรียกดูชั้นดิน PMTiles, ดิน KML, พืช/สิ่งปกคลุมดิน, ขอบเขต และข้อมูลหน่วยงานภายนอก — ทุก endpoint ตอบเป็น JSON และเปิด CORS

ฐาน URL
https://biggeoearth.eotgis.com/api/
หน้าเว็บ: https://biggeoearth.eotgis.com/

หลังอัปไฟล์ขึ้นเซิร์ฟเวอร์ ให้เปิด api/?action=health เป็นอันดับแรก — จะบอกในที่เดียวว่าชุดข้อมูลไหนขึ้นไม่ครบและ PHP ตัวไหนขาด

1) รายการบริการ

คลิกชื่อไฟล์เพื่อเปิดดูผลลัพธ์จริง

บริการEndpointใช้ทำอะไร
แคตตาล็อกรวมapi/ · catalog.phpรายการ API ทั้งระบบ + หน่วยงานภายนอก
พืช / สิ่งปกคลุมดินlandcover.phpหาไฟล์ GeoTIFF ตามปี/พื้นที่
ดิน KML ปี 2558soil.phpหาไฟล์ KML ตาม จังหวัด/อำเภอ/ตำบล
ดิน PMTilespmtiles.phpชั้นในโฟลเดอร์ soil/
ขอบเขตการปกครองboundary.phpตรวจไฟล์ GeoJSON
เครื่องมือแผนที่tools.phpวัดระยะ พิมพ์ แชร์ ดาวน์โหลด
พร็อกซีภายนอกapi-proxy.phpTMD / DWR / DOA

2) ชั้นดิน PMTiles soil/

ใช้กับโฟลเดอร์ soil/*.pmtiles และแผง ชั้นข้อมูลดิน (PMTiles) ในหน้าแผนที่

Actions

actionคำอธิบาย
catalogสรุปชั้นทั้งหมด + ขนาดไฟล์ (ค่าเริ่มต้น)
layersรายการชั้น (กรองด้วย group= ได้)
resolveรายละเอียดชั้นเดียว (key= บังคับ)
healthตรวจว่าไฟล์ครบหรือไม่

คีย์ชั้นหลัก

  • ความเสี่ยง: drought, floodprone, landslideprone
  • การชะล้าง: soil_erosion
  • ความเหมาะสม: suit_rice, suit_corn, suit_cassava, suit_rubber, suit_oilpalm
  • เขตปลูก: zone_rice, zone_corn, zone_cassava, zone_rubber, zone_oilpalm

ตัวอย่าง URL

api/pmtiles.php
api/pmtiles.php?action=layers
api/pmtiles.php?action=resolve&key=suit_rice
api/pmtiles.php?action=health
เปิด catalog

      

หมายเหตุ: ไฟล์ .pmtiles ใหญ่ — เซิร์ฟเวอร์ต้องรองรับ HTTP Range Request

3) ดิน KML ปี 2558

actionคำอธิบาย
catalogสรุปบริการ + ประเภทดิน
typesสี/ชื่อประเภทดิน
indexทั้ง kml/soil_index.json
resolveหาไฟล์ KML ตามพื้นที่
health / pingตรวจสถานะบริการ
api/soil.php?action=resolve&province=ขอนแก่น
api/soil.php?action=resolve&province=ขอนแก่น&amphoe=เมืองขอนแก่น
api/soil.php?action=resolve&province=ขอนแก่น&amphoe=เมืองขอนแก่น&tambon=ในเมือง
เปิด catalog

      

ต้องการ: kml/soil_index.json, kml/by_province/, kml/by_amphoe/, kml/by_tambon/

4) พืช / สิ่งปกคลุมดิน

api/landcover.php
api/landcover.php?action=classes
api/landcover.php?action=resolve&year=2025&province=ขอนแก่น
เปิด catalog

      

ต้องการโฟลเดอร์: TH-2024-wgs84/, TH-2025-wgs84/

5) ขอบเขตการปกครอง

api/boundary.php
api/boundary.php?action=health
  • Boundary_Thailand/Thailand_pro.geojson
  • Boundary_Thailand/Thailand_amp.geojson
  • Boundary_Thailand/Thailand_tam.geojson

    

6) เครื่องมือแผนที่

อธิบายปุ่มในแผง เครื่องมือ ของหน้าแผนที่:

  • วัดระยะ
  • พิมพ์แผนที่
  • แชร์แผนที่ (ลิงก์พร้อมพิกัด/ขอบเขต)
  • ดาวน์โหลด (GeoJSON / KML / PNG)
เปิด tools.php

7) พร็อกซีภายนอก

ใช้เมื่อ API ภายนอกติด CORS — เรียกผ่านเซิร์ฟเวอร์ของเรา

../api-proxy.php?src=weatherToday
../api-proxy.php?src=weather3Hours
../api-proxy.php?src=dailyForecast
../api-proxy.php?src=dwrWaterStations
../api-proxy.php?src=doaCropEw
../api-proxy.php?src=__diag

ทุก src มี cache ฝั่งเซิร์ฟเวอร์ — ยิงออกไปต้นทางอย่างมาก 1 ครั้งต่อรอบ TTL ไม่ว่าจะมีผู้ใช้กี่คน และถ้าต้นทางล่มจะเสิร์ฟข้อมูลเก่าแทนการพัง

ส่วนหัวตอบกลับความหมาย
X-Cache: HITได้จาก cache ไม่ได้แตะต้นทาง (เร็วสุด)
X-Cache: MISSเพิ่งดึงสดจากต้นทางและเก็บ cache ไว้แล้ว
X-Cache: STALEต้นทางล่ม — เสิร์ฟข้อมูลเก่าแทน (ดู Age ว่าเก่ากี่วินาที)
HTTP 503ต้นทางล่มและไม่มีข้อมูลเก่าเลย — ลองใหม่ตาม Retry-After

เติม &refresh=1 เพื่อบังคับดึงใหม่ (จำกัดไม่เกิน 1 ครั้ง/นาที ต่อ src)

8) หน่วยงานภายนอก

API จากหน่วยงานภายนอกที่ใช้ในระบบ (TMD, RID, DGR, เสาตรวจวัด ฯลฯ) — คัดเฉพาะ endpoint ที่เป็น JSON

กำลังโหลดรายการ…

9) ตัวอย่าง JavaScript

PMTiles

const res = await fetch('api/pmtiles.php?action=resolve&key=suit_rice');
const data = await res.json();
if (data.ok) {
  console.log(data.layer.url); // path บนแผนที่
}

ดิน KML

const res = await fetch('api/soil.php?action=resolve&province=' + encodeURIComponent('ขอนแก่น'));
const data = await res.json();
if (data.ok) {
  console.log(data.url, data.mb);
}

10) รหัสผิดพลาดที่พบบ่อย

สถานการณ์ความหมาย
ok: false + province_requiredยังไม่ได้ส่งจังหวัด
soil_index_missingยังไม่มี kml/soil_index.json
file_missing / layer_not_foundไม่พบไฟล์หรือคีย์ชั้น
HTTP 500 จาก api-proxy.phpเปิด ?src=__diag เพื่อตรวจ PHP/cURL

11) ใช้ร่วมกับหน้าแผนที่

1
เปิด index.html
2
เลือก จังหวัด / อำเภอ / ตำบล
3
เปิดแผง ชั้นข้อมูลดิน (PMTiles) หรือ สถานภาพทรัพยากรดิน
4
ใช้แผง เครื่องมือ สำหรับวัดระยะ พิมพ์ แชร์ ดาวน์โหลด

ดาวน์โหลด PNG: แนะนำพื้นหลัง OSM หรือ Carto Light (Google อาจติด CORS)

โมดูลใช้ข้อมูล
gis-boundary.jsขอบเขตการปกครอง
gis-soil-kml.jsดิน KML ตามพื้นที่
gis-soil-pmtiles.jsดิน PMTiles จาก soil/
gis-tools.jsวัดระยะ พิมพ์ แชร์ ดาวน์โหลด
gis-maps.jsพืช / GeoTIFF

12) ทดสอบสด

กำลังโหลดแคตตาล็อก…


    

อัปเดต: สิงหาคม 2026 · สำนักงานเศรษฐกิจการเกษตร · GeoAI for agriculture
เอกสารนี้แทนไฟล์ Markdown เดิม — เปิดใช้งานผ่าน api/docs.html