เอกสาร MapScale
•••
ผลิตภัณฑ์
ผลิตภัณฑ์

Static Maps

สร้างภาพแผนที่สำหรับ email, card, PDF, social preview และ server-rendered page

สิ่งที่คุณจะทำได้

รับไฟล์ PNG จาก URL โดยไม่ต้องรัน JavaScript

สร้างภาพแผนที่

path กำหนดจุดศูนย์กลาง ระดับซูม และขนาดภาพ query parameter เลือก style ภาษา markers หรือเส้นทาง

LIVE API PLAYGROUND

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

ดำเนินการต่อเพื่อเรียก request จริงจากหน้า docs

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

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

Request preview
curl \
  -H "X-MapScale-Key: $MAPSCALE_API_KEY" \
  "https://api.mapscale.io/v1/static/100.5018%2C13.7563%2C12/1200x630.png?lang=th"
Response จริง
Response เริ่มต้น
{
  "status": "200",
  "contentType": "image/png",
  "description": "A rendered PNG static map."
}

ตัวอย่างที่สอง พร้อม marker

@2x ขอภาพความหนาแน่นสองเท่าสำหรับจอ high-DPI ส่วน markers ฝัง pin ลงในภาพเลย เพราะฝั่งรับไม่มี JavaScript มาวาดเพิ่ม

LIVE API PLAYGROUND

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

ดำเนินการต่อเพื่อเรียก request จริงจากหน้า docs

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

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

Request preview
curl \
  -H "X-MapScale-Key: $MAPSCALE_API_KEY" \
  "https://api.mapscale.io/v1/static/100.5348%2C13.7466%2C14/600x400%402x.png?lang=th"
Response จริง
Response เริ่มต้น
{
  "status": "200",
  "contentType": "image/png",
  "description": "A rendered PNG static map."
}

เลือกขนาดที่ใช้งานได้จริง

สร้างภาพตาม aspect ratio สุดท้ายเพื่อไม่ให้ label ถูกตัด ใช้ภาพต้นฉบับที่ใหญ่ขึ้นสำหรับจอความหนาแน่นสูง แล้วจำกัดขนาดที่แสดงด้วย CSS

ให้บริการภาพอย่างปลอดภัย

สำหรับแผนที่ส่วนตัวหรือเฉพาะผู้ใช้ ให้ขอภาพจาก server ของคุณและ cache ตามอายุที่เหมาะสม อย่าใส่ secret key ใน HTML สาธารณะหรือ URL ใน email

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

On this page