1. สร้าง trial key

Trial key ใช้กับ Autocomplete, Tiles และ Static Maps ส่วน Geocoding และ Routing ต้องใช้ account key ที่เปิดผลิตภัณฑ์นั้นแล้ว

แก้ไข input ส่ง request จริง และตรวจสอบ response จริง

Request body

curl \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","companyName":"Your Company","allowedOrigin":"https://example.com"}' \
  "https://api.mapscale.io/v1/trial-key"

Response เริ่มต้น

{
  "accountId": "acct_trial_123",
  "key": "pk_test_••••••••",
  "keyPrefix": "pk_test_ab12cd34",
  "enabledProducts": [
    "tiles",
    "autocomplete",
    "static"
  ],
  "limits": {
    "rateLimitTier": "trial",
    "note": "Evaluation limits apply."
  },
  "examples": {
    "styleUrl": "https://api.mapscale.io/styles/v1/streets?key=pk_test_••••••••",
    "autocompleteUrl": "https://api.mapscale.io/v1/autocomplete?q=Siam&session_token=demo&key=pk_test_••••••••"
  }
}

2. ส่ง request

เก็บ key ที่ได้รับไว้ใน MAPSCALE_API_KEY แล้วส่งด้วย X-MapScale-Key โดย session_token หนึ่งตัวแทนการค้นหาหนึ่งครั้ง

แก้ไข input ส่ง request จริง และตรวจสอบ response จริง

input ที่แก้ไขได้

qจำเป็นข้อความอย่างน้อย 1

langไม่บังคับข้อความ17 ตัวเลือก

session_tokenไม่บังคับข้อความ

bboxไม่บังคับข้อความ

proximityไม่บังคับข้อความ

typesไม่บังคับข้อความ

curl \
  -H "X-MapScale-Key: $MAPSCALE_API_KEY" \
  "https://api.mapscale.io/v1/autocomplete?q=Siam&lang=th"

Response เริ่มต้น

{
  "predictions": [
    {
      "place_id": "place_bangkok_123",
      "description": "Siam Paragon, Pathum Wan, Bangkok",
      "structured_formatting": {
        "main_text": "Siam Paragon",
        "secondary_text": "Pathum Wan, Bangkok"
      }
    }
  ]
}

ตัวอย่างที่สอง: การสะกดแบบไทย

"Thong Lo" และ "ทองหล่อ" ค้นเจอย่านเดียวกัน — Autocomplete จับคู่ได้ทั้งคำสะกดแบบโรมันและอักษรไทย

แก้ไข input ส่ง request จริง และตรวจสอบ response จริง

input ที่แก้ไขได้

qจำเป็นข้อความอย่างน้อย 1

langไม่บังคับข้อความ17 ตัวเลือก

session_tokenไม่บังคับข้อความ

bboxไม่บังคับข้อความ

proximityไม่บังคับข้อความ

typesไม่บังคับข้อความ

curl \
  -H "X-MapScale-Key: $MAPSCALE_API_KEY" \
  "https://api.mapscale.io/v1/autocomplete?q=thong+lo&lang=th"

Response เริ่มต้น

{
  "predictions": [
    {
      "place_id": "place_bangkok_123",
      "description": "Siam Paragon, Pathum Wan, Bangkok",
      "structured_formatting": {
        "main_text": "Siam Paragon",
        "secondary_text": "Pathum Wan, Bangkok"
      }
    }
  ]
}

3. อ่าน response

แสดง predictions[].description ในรายการแนะนำ และเก็บ predictions[].place_id เพื่อดูรายละเอียดเมื่อผู้ใช้เลือก

อ่านต่อขั้นตอนถัดไป →

เรียก API ครั้งแรก

1. สร้าง trial key

เข้าสู่ระบบหรือสร้างบัญชี

2. ส่ง request

เข้าสู่ระบบหรือสร้างบัญชี

input ที่แก้ไขได้

ตัวอย่างที่สอง: การสะกดแบบไทย

เข้าสู่ระบบหรือสร้างบัญชี

input ที่แก้ไขได้

3. อ่าน response

On this page