แพลตฟอร์มและ SDK
คู่มือแพลตฟอร์ม
การเชื่อมต่อ REST API
เรียก MapScale จากภาษา server ใดก็ได้ผ่าน HTTPS พร้อม JSON และ GeoJSON response
สิ่งที่คุณจะทำได้
ใช้ REST API สำหรับ search, routing, matrix, static image และงานฝั่ง server
Base URL และ authentication
ส่ง production traffic ไปที่ https://api.mapscale.io และส่ง key ผ่าน X-MapScale-Key สำหรับ endpoint ที่ป้องกัน
อ่าน response
JSON response ใช้ HTTP status มาตรฐาน Search API ส่งข้อมูลแบบ GeoJSON ส่วน image และ tile endpoint ส่ง binary พร้อม Content-Type ที่เหมาะสม
จัดการ error
400 คือ input ผิด, 401 คือไม่มี auth, 403 คือข้อจำกัดของ key, 429 ให้ชะลอ request และ 5xx ให้ retry แบบจำกัดด้วย exponential backoff
ตัวอย่างที่ 2 — upstream ล้มเหลวแบบ retry ได้
เมื่อ backend ค้นหาที่อยู่ไม่พร้อมใช้งาน API จะตอบ 503 ด้วย shape {error:{code,message}} แบบเดียวกับทุก endpoint ไม่ใช่ 500 เปล่า ๆ หรือหน้า HTML error