ข้อมูลเบื้องต้น
Maps Static API จะแสดงรูปภาพ (GIF, PNG หรือ JPEG) เพื่อตอบกลับคำขอ HTTP ผ่าน URL สำหรับแต่ละคำขอ คุณสามารถระบุตำแหน่งของแผนที่ ขนาดของภาพ ระดับการซูม ประเภทของแผนที่ และตำแหน่งของเครื่องหมายเสริมที่ตำแหน่งบนแผนที่ นอกจากนี้ คุณยังติดป้ายกำกับเครื่องหมายโดยใช้อักขระที่เป็นตัวอักษรและตัวเลขคละกันได้อีกด้วย
รูปภาพ Maps Static API ฝังอยู่ในแอตทริบิวต์ src
ของแท็ก <img>
หรือเทียบเท่าในภาษาโปรแกรมอื่นๆ
เอกสารนี้อธิบายรูปแบบ URL ของ Maps Static API ที่จำเป็นและพารามิเตอร์ที่ใช้ได้ นอกจากนี้ยังแนะนำเคล็ดลับและกลเม็ดบางอย่างในการระบุ URL ของคุณ
ข้อควรปฏิบัติก่อนที่จะเริ่มต้น
เอกสารนี้มีไว้สำหรับนักพัฒนาเว็บไซต์และอุปกรณ์เคลื่อนที่ที่ต้องการใส่รูปภาพ Maps Static API ไว้ในหน้าเว็บหรือแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ โดยให้ข้อมูลเบื้องต้นเกี่ยวกับการใช้ API และข้อมูลอ้างอิงในพารามิเตอร์ที่มีอยู่
ก่อนที่จะเริ่มพัฒนาด้วย Maps Static API โปรดอ่านข้อกำหนดในการตรวจสอบสิทธิ์ (คุณต้องมีคีย์ API) และข้อมูล การใช้งาน API และการเรียกเก็บเงิน (คุณต้องเปิดใช้การเรียกเก็บเงินในโปรเจ็กต์)
พารามิเตอร์ของ URL
URL ของ Maps Static API ต้องอยู่ในรูปแบบต่อไปนี้
https://maps.googleapis.com/maps/api/staticmap?parameters
หากเว็บไซต์ของคุณมีการเข้าถึงผ่าน HTTPS คุณต้องโหลดรูปภาพ Maps Static API ผ่าน HTTPS ด้วยเพื่อหลีกเลี่ยงการแจ้งเตือนความปลอดภัยของเบราว์เซอร์ นอกจากนี้ เรายังแนะนำให้ใช้ HTTPS หากคำขอมีข้อมูลที่ละเอียดอ่อนของผู้ใช้ เช่น ตำแหน่งของผู้ใช้ ดังนี้
https://maps.googleapis.com/maps/api/staticmap?parameters
ไม่ว่าจะใช้ HTTP หรือ HTTPS คุณก็จำเป็นต้องใช้พารามิเตอร์ของ URL บางรายการ แต่บางรายการจะไม่บังคับ เช่นเดียวกับมาตรฐานใน URL พารามิเตอร์ทั้งหมดจะถูกคั่นด้วยอักขระเครื่องหมายแอมเพอร์แซนด์ (&
) รายการพารามิเตอร์และค่าที่เป็นไปได้มีการแจกแจงอยู่ในเอกสารนี้
Maps Static API จะกำหนดภาพแผนที่โดยใช้พารามิเตอร์ URL ต่อไปนี้
พารามิเตอร์ตำแหน่ง
center
(ต้องระบุถ้าไม่มีเครื่องหมาย) กำหนดจุดศูนย์กลางของแผนที่ โดยมีระยะห่างจากขอบทั้งหมดของแผนที่ พารามิเตอร์นี้จะใช้ตำแหน่งเป็นคู่ {ละติจูด,longitude} ที่คั่นด้วยเครื่องหมายจุลภาค (เช่น "40.714728,-73.998672") หรือที่อยู่สตริง (เช่น "city hall, new york, ny") เพื่อระบุสถานที่ที่ไม่ซ้ำบนพื้นโลก ดูข้อมูลเพิ่มเติมได้ที่สถานที่ตั้งzoom
(ต้องระบุหากไม่มีเครื่องหมาย) จะกำหนดระดับการซูมของแผนที่ ซึ่งจะกำหนดระดับการขยายของแผนที่ พารามิเตอร์นี้จะรับค่าตัวเลขที่สอดคล้องกับระดับการซูมของภูมิภาคที่ต้องการ ดูข้อมูลเพิ่มเติมได้ที่ระดับการซูม
จับคู่พารามิเตอร์
size
(ต้องระบุ) กำหนดขนาดเป็นรูปสี่เหลี่ยมผืนผ้าของรูปภาพแผนที่ พารามิเตอร์นี้ใช้สตริงในรูปแบบ{horizontal_value}x{vertical_value}
ตัวอย่างเช่น500x400
กำหนดแผนที่กว้าง 500 พิกเซล x สูง 400 พิกเซล Maps ที่มีขนาดเล็กกว่า 180 พิกเซลจะแสดงโลโก้ Google ที่มีขนาดเล็กกว่า พารามิเตอร์นี้ได้รับผลกระทบจากพารามิเตอร์scale
ขนาดเอาต์พุตสุดท้ายคือผลคูณของค่าขนาดและอัตราส่วนscale
(ไม่บังคับ) จะส่งผลต่อจำนวนพิกเซลที่จะแสดงผลscale=2
จะแสดงผลพิกเซลเป็นสองเท่าของscale=1
ในขณะที่ยังคงพื้นที่ที่ครอบคลุมและระดับของรายละเอียดเหมือนเดิม (เช่น เนื้อหาของแผนที่ไม่มีการเปลี่ยนแปลง) ซึ่งจะเป็นประโยชน์สำหรับการพัฒนาเพื่อการแสดงผลที่มีความละเอียดสูง ค่าเริ่มต้นคือ1
ค่าที่ยอมรับคือ1
และ2
ดูค่าสเกลสำหรับข้อมูลเพิ่มเติมformat
(ไม่บังคับ) กำหนดรูปแบบของรูปภาพที่ได้ โดยค่าเริ่มต้น Maps Static API จะสร้างรูปภาพ PNG มีรูปแบบที่เป็นไปได้หลายรูปแบบ รวมถึงประเภท GIF, JPEG และ PNG รูปแบบที่ใช้จะขึ้นอยู่กับว่าคุณต้องการนำเสนอรูปภาพอย่างไร JPEG มักจะบีบอัดได้มากกว่า ส่วน GIF และ PNG มีรายละเอียดมากกว่า ดูข้อมูลเพิ่มเติมได้ที่รูปแบบรูปภาพmaptype
(ตัวเลือก) กำหนดประเภทของแผนที่ที่จะสร้าง ค่า maptype ได้มีอยู่หลายค่า ได้แก่roadmap
,satellite
,hybrid
และterrain
สำหรับข้อมูลเพิ่มเติม โปรดดูประเภทแผนที่ API แบบคงที่ของ Mapslanguage
(ไม่บังคับ) กำหนดภาษาที่จะใช้สำหรับการแสดงป้ายกำกับบนชิ้นส่วนแผนที่ โปรดทราบว่าพารามิเตอร์นี้รองรับเฉพาะการ์ดในบางประเทศเท่านั้น หากชุดการ์ดไม่รองรับภาษาที่ขอดังกล่าว ระบบจะใช้ภาษาเริ่มต้นสำหรับชุดการ์ดดังกล่าวregion
(ไม่บังคับ) กำหนดเขตแดนที่เหมาะสมเพื่อแสดง โดยอิงตามความละเอียดอ่อนทางภูมิศาสตร์และการเมือง ยอมรับรหัสภูมิภาคที่ระบุเป็นค่า ccTLD 2 อักขระ ("โดเมนระดับบนสุด") ดูรายละเอียดการครอบคลุมของ Google Maps Platform สำหรับภูมิภาคที่รองรับ
พารามิเตอร์ฟีเจอร์
map_id
(ไม่บังคับ) ระบุตัวระบุสำหรับแผนที่ที่เจาะจง รหัสแผนที่จะเชื่อมโยงแผนที่กับรูปแบบหรือฟีเจอร์หนึ่งๆ และต้องเป็นของโปรเจ็กต์เดียวกับคีย์ API ที่ใช้ในการเริ่มต้นแผนที่ ดูข้อมูลเพิ่มเติมได้ที่การใช้รหัสแผนที่markers
(ไม่บังคับ) กำหนดตัวทำเครื่องหมายอย่างน้อย 1 รายการเพื่อแนบกับรูปภาพที่ตำแหน่งที่ระบุ พารามิเตอร์นี้ใช้คำจำกัดความของตัวทำเครื่องหมายเดียวที่มีพารามิเตอร์ซึ่งคั่นด้วยอักขระไปป์ (|
) คุณสามารถวางตัวทำเครื่องหมายหลายตัวไว้ภายในพารามิเตอร์markers
เดียวกันได้ตราบใดที่แสดงรูปแบบเดียวกัน คุณสามารถเพิ่มตัวทำเครื่องหมายเพิ่มเติมสำหรับรูปแบบที่แตกต่างกันได้โดยเพิ่มพารามิเตอร์markers
โปรดทราบว่าหากคุณใส่ตัวทำเครื่องหมายสำหรับแผนที่ คุณไม่จำเป็นต้องระบุพารามิเตอร์center
และzoom
(โดยปกติจำเป็น) ดูข้อมูลเพิ่มเติมได้ที่ตัวทำเครื่องหมาย API แบบคงที่ของ Mapspath
(ไม่บังคับ) กําหนดเส้นทางเดียวที่มีจุดเชื่อมต่อตั้งแต่ 2 จุดขึ้นไปเพื่อวางซ้อนบนรูปภาพในตําแหน่งที่ระบุ พารามิเตอร์นี้ใช้สตริงของการกำหนดจุดซึ่งคั่นด้วยอักขระไปป์ (|
) หรือโพลีไลน์ที่เข้ารหัสโดยใช้คำนำหน้าenc:
ภายในการประกาศตำแหน่งของเส้นทาง คุณอาจระบุเส้นทางเพิ่มเติมได้โดยการเพิ่มพารามิเตอร์path
อีก โปรดทราบว่าหากคุณระบุเส้นทางสำหรับแผนที่ คุณไม่จำเป็นต้องระบุพารามิเตอร์center
และzoom
(โดยปกติจำเป็น) ดูข้อมูลเพิ่มเติมได้ที่เส้นทาง API แบบคงที่ของ Mapsvisible
(ไม่บังคับ) ระบุสถานที่อย่างน้อย 1 แห่งที่ควรยังคงเห็นบนแผนที่ แม้ว่าจะไม่มีเครื่องหมายหรือตัวบ่งชี้อื่นๆ ปรากฏขึ้น ใช้พารามิเตอร์นี้เพื่อให้มั่นใจว่าฟีเจอร์หรือตำแหน่งในแผนที่บางรายการจะแสดงใน Maps Static APIstyle
(ไม่บังคับ) กำหนดรูปแบบที่กำหนดเองเพื่อเปลี่ยนการนำเสนอสถานที่หนึ่งๆ (ถนน สวนสาธารณะ และฟีเจอร์อื่นๆ) ของแผนที่ พารามิเตอร์นี้ใช้อาร์กิวเมนต์feature
และelement
ที่ระบุฟีเจอร์เพื่อจัดรูปแบบ และชุดการดำเนินการเกี่ยวกับรูปแบบ เพื่อนำไปใช้กับฟีเจอร์ที่เลือก คุณใส่รูปแบบได้หลายแบบโดยเพิ่มพารามิเตอร์style
อีก สำหรับข้อมูลเพิ่มเติม โปรดดูคู่มือเกี่ยวกับแผนที่ที่มีการจัดรูปแบบ
พารามิเตอร์คีย์และลายเซ็น
key
(จำเป็น) ช่วยให้คุณตรวจสอบการใช้ API ของแอปพลิเคชันใน Google Cloud Console และช่วยให้ Google ติดต่อคุณเกี่ยวกับแอปพลิเคชันได้หากจำเป็น ดูข้อมูลเพิ่มเติมได้ที่ใช้คีย์ API กับ Maps Static APIsignature
(แนะนำ) เป็นลายเซ็นดิจิทัลที่ใช้เพื่อยืนยันว่าคำขอที่สร้างเว็บไซต์โดยใช้คีย์ API ของคุณได้รับอนุญาต คำขอที่ไม่มีลายเซ็นดิจิทัลอาจล้มเหลว ดูข้อมูลเพิ่มเติมได้ที่ใช้ลายเซ็นดิจิทัล
ข้อจำกัดด้านขนาด URL
URL ของ Maps Static API จำกัดจำนวนอักขระ 16,384 ตัว ในทางปฏิบัติ คุณอาจไม่ต้องใช้ URL ยาวกว่านี้ เว้นแต่ว่าจะสร้างแผนที่ที่ซับซ้อนซึ่งมีเครื่องหมายและเส้นทางจำนวนมาก
การใช้พารามิเตอร์
Maps Static API ใช้งานง่ายเนื่องจากประกอบด้วย URL ที่ทำเป็นพารามิเตอร์เพียงอย่างเดียว ส่วนนี้จะอธิบายวิธีใช้พารามิเตอร์เหล่านี้ ในการสร้าง URL
การระบุตำแหน่งที่ตั้ง
Maps Static API จะต้องสามารถระบุสถานที่บนแผนที่ได้อย่างแม่นยำ ทั้งเพื่อโฟกัสแผนที่ที่ตำแหน่งที่ถูกต้อง (โดยใช้พารามิเตอร์ center
) และ/หรือเพื่อวางหมุดที่ไม่บังคับ (โดยใช้พารามิเตอร์ markers
) ที่ตำแหน่งต่างๆ บนแผนที่ Maps Static API ใช้ตัวเลข (ค่าละติจูดและลองจิจูด) หรือสตริง (ที่อยู่) เพื่อระบุสถานที่เหล่านี้ ค่าเหล่านี้ระบุตำแหน่งที่มีพิกัดภูมิศาสตร์
พารามิเตอร์หลายรายการ (เช่น พารามิเตอร์ markers
และ path
) ใช้หลายตำแหน่ง ในกรณีดังกล่าว สถานที่จะคั่นด้วยอักขระไปป์ (|
)
ละติจูดและลองจิจูด
ละติจูดและลองจิจูดจะกำหนดโดยใช้ตัวเลขภายในสตริงข้อความที่คั่นด้วยเครื่องหมายจุลภาคที่มีทศนิยม 6 ตำแหน่ง ตัวอย่างเช่น "40.714728,-73.998672" เป็นค่าพิกัดทางภูมิศาสตร์ที่ถูกต้อง ไม่คำนึงถึงทศนิยม ทั้ง 6 ตำแหน่ง
ค่าลองจิจูดจะอิงตามระยะทางจากกรีนิช ประเทศอังกฤษ ซึ่งเป็นบ้านของเส้นเมริเดียนแรก เนื่องจากกรีนิชตั้งอยู่ที่ละติจูด 51.477222 เราจึงป้อนค่า center
เป็น 51.477222,0
เพื่อตั้งศูนย์กลางของแผนที่ที่กรีนิชได้ ดังนี้
ค่าละติจูดและลองจิจูดต้องตรงกับตำแหน่งที่ถูกต้องบนพื้นโลก ละติจูดสามารถใช้ค่าใดก็ได้ระหว่าง -90
ถึง 90
ส่วนค่าลองจิจูดจะมีค่าระหว่าง -180
ถึง 180
หากคุณระบุค่าละติจูดหรือลองจิจูดไม่ถูกต้อง คำขอจะถูกปฏิเสธโดยถือว่าเป็นคำขอที่ไม่ถูกต้อง
ที่อยู่
คนส่วนใหญ่ไม่พูดละติจูดและลองจิจูด แต่จะระบุสถานที่โดยใช้ที่อยู่ กระบวนการเปลี่ยนที่อยู่ให้เป็นจุดทางภูมิศาสตร์เรียกว่าการระบุพิกัดทางภูมิศาสตร์ และบริการ Maps Static API จะทำการระบุพิกัดทางภูมิศาสตร์ให้คุณได้หากระบุที่อยู่ที่ถูกต้อง
ในพารามิเตอร์ใดก็ตามที่ระบุละติจูด/ลองจิจูดได้ ให้ระบุสตริงที่ระบุที่อยู่แทน Google จะเข้ารหัสพิกัดภูมิศาสตร์ของที่อยู่ และมอบค่าละติจูด/ลองจิจูดให้แก่บริการ Maps Static API เพื่อใช้ในการวางเครื่องหมายหรือระบุตำแหน่ง สตริงควรเป็นแบบเข้ารหัส URL ดังนั้นที่อยู่อย่าง "City Hall, New York, NY" ควรแปลงเป็น "City+Hall,New+York,NY"
โปรดทราบว่าที่อยู่อาจแสดงตำแหน่งที่แน่นอน เช่น ที่อยู่ โพลีไลน์ เช่น เส้นทางที่มีชื่อ หรือพื้นที่รูปหลายเหลี่ยม เช่น เมือง ประเทศ หรืออุทยานแห่งชาติ เพื่อให้ได้ผลลัพธ์แบบโพลีเชิงเส้นและรูปหลายเหลี่ยม เซิร์ฟเวอร์ Maps Static API จะใช้จุดศูนย์กลางของเส้น/พื้นที่เป็นศูนย์ที่อยู่ หากคุณมีข้อสงสัยว่าที่อยู่หนึ่งๆ อาจมีการระบุพิกัดทางภูมิศาสตร์ได้อย่างไร คุณสามารถทดสอบที่อยู่ได้โดยใช้ ยูทิลิตีการระบุพิกัดทางภูมิศาสตร์นี้
ตัวอย่างต่อไปนี้สร้างรูปภาพแผนที่แบบคงที่สำหรับเบิร์กลีย์ แคลิฟอร์เนีย
https://maps.googleapis.com/maps/api/staticmap?center=Berkeley,CA&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
ระดับการย่อขยาย
แผนที่บน Google แผนที่มี "ระดับการซูม" ที่เป็นจำนวนเต็มซึ่งกำหนดความละเอียดของมุมมองปัจจุบัน ระดับการซูมระหว่าง 0
(ระดับการซูมต่ำสุดซึ่งมองเห็นได้ทั้งโลกในแผนที่เดียว) และ 21+
(จนถึงถนนและอาคารแต่ละอาคาร) จะทำได้ภายในมุมมอง roadmap
เริ่มต้น โครงร่างสิ่งปลูกสร้าง (หากมี) จะปรากฏบนแผนที่รอบๆ ระดับการซูม 17
ค่านี้แตกต่างกันไปในแต่ละพื้นที่ และอาจเปลี่ยนแปลงได้ตามเมื่อเวลาผ่านไป
Google Maps ตั้งค่าระดับการซูม 0
ให้ครอบคลุมทั้งโลก
ระดับการซูมที่สำเร็จแต่ละระดับจะเพิ่มความแม่นยำเป็น 2 เท่าทั้งในมิติข้อมูลแนวนอนและแนวตั้ง ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีการแก้ไขได้ที่เอกสารประกอบเกี่ยวกับ JavaScript API ของ Google Maps
หมายเหตุ: ระดับการซูมบางระดับจะไม่ปรากฏขึ้นในบางตำแหน่งบนพื้นโลก ระดับการซูม จะแตกต่างกันไปโดยขึ้นอยู่กับสถานที่ เนื่องจากข้อมูลในบางส่วนของโลก มีรายละเอียดมากกว่าของที่อื่นๆ
หากคุณส่งคำขอระดับการซูมที่ไม่มีชิ้นส่วนแผนที่อยู่ API แบบคงที่ของ Maps จะแสดงรูปภาพว่างเปล่าแทน
ระดับความละเอียดโดยประมาณที่คุณคาดว่าจะเห็นในแต่ละระดับการซูมมีดังนี้
- 1: โลก
- 5: ผืนดินขนาดใหญ่/ทวีป
- 10: เมือง
- 15: ถนน
- 20: อาคาร
ตัวอย่างนี้ขอแผนที่แมนฮัตตัน 2 ฉบับที่ค่า center
เดียวกัน แต่ที่การซูมระดับ 12 และ 14 ตามลำดับ
https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
ขนาดรูปภาพ
พารามิเตอร์ size
ร่วมกับ center
จะกำหนดพื้นที่ที่ครอบคลุมของแผนที่ นอกจากนี้ยังกำหนดขนาดเอาต์พุตของแผนที่เป็นพิกเซล เมื่อคูณด้วยค่า scale
(ซึ่งโดยค่าเริ่มต้นคือ 1
)
ตารางนี้แสดงค่าสูงสุดที่อนุญาตสำหรับพารามิเตอร์ size
ที่ค่า scale
แต่ละค่า
scale=1 |
scale=2 |
---|---|
640x640 |
640x640 (แสดงขนาด 1280x1280 พิกเซล) |
ตัวอย่างนี้แสดง "แผ่น" ของโลกตรงเส้นศูนย์สูตรที่ระดับการซูม 1
https://maps.googleapis.com/maps/api/staticmap?center=0,0&zoom=1&size=400x50&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
ตัวอย่างนี้ขอแผนที่ขนาดเล็กขนาด 100 x 100 พิกเซลโดยจัดให้อยู่กึ่งกลางของภูมิภาคเดียวกัน โปรดสังเกตโลโก้ Google ที่มีขนาดเล็กกว่า:
https://maps.googleapis.com/maps/api/staticmap?center=0,0&zoom=1&size=100x100&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
สเกลค่า
พารามิเตอร์ size
ของ Maps Static API จะกำหนดขนาดแผนที่เป็นพิกเซล เพื่อให้แผนที่ที่มี size=200x200
แสดงผลเป็น 200 พิกเซล x 200 พิกเซล บนหน้าจอคอมพิวเตอร์ LCD ซึ่งโดยปกติจะแสดงประมาณ 100 พิกเซลต่อนิ้ว (ppi) แผนที่ขนาด 200x200 จะมีขนาดประมาณ 2 นิ้วในแต่ละด้าน
อย่างไรก็ตาม อุปกรณ์เคลื่อนที่มีหน้าจอความละเอียดสูงที่มีความหนาแน่นของพิกเซลมากกว่า 300ppi เพิ่มขึ้น ซึ่งปัจจัยข้อใดข้อหนึ่งต่อไปนี้
- ลดขนาดของรูปภาพขนาด 200x200 พิกเซลให้เหลือเพียง 0.7 นิ้ว แสดงป้ายกำกับและไอคอนที่มีขนาดเล็กเกินกว่าที่จะอ่านได้ หรือ
- ปรับขนาด (ซูม) รูปภาพเพื่อให้อ่านได้ง่ายมากขึ้นจนรูปภาพเบลอหรือแตกเป็นพิกเซล
ขนาดเล็กเกินไป | ไม่ชัดเจน |
---|---|
![]() |
![]() |
เมื่อพัฒนาสำหรับอุปกรณ์เคลื่อนที่ คุณสามารถใช้พารามิเตอร์ scale
ของ API เพื่อแสดงภาพแผนที่ที่มีความละเอียดสูงขึ้นซึ่งช่วยแก้ปัญหาข้างต้นได้ ค่า scale
จะคูณด้วย size
เพื่อระบุขนาดเอาต์พุตจริงของรูปภาพเป็นพิกเซล โดยไม่เปลี่ยนพื้นที่ที่ครอบคลุมของแผนที่ ค่าเริ่มต้นของ scale
คือ 1 ค่าที่ยอมรับคือ 1 และ 2
ตัวอย่างเช่น ค่าสเกล 2 จะแสดงผลพื้นที่ครอบคลุมแผนที่เดียวกับคำขอที่ไม่ได้ระบุสเกล แต่มีพิกเซลเป็น 2 เท่าในแต่ละมิติข้อมูล ซึ่งรวมถึงถนนและป้ายกำกับเพื่อให้อ่านได้ง่ายในหน้าจอความละเอียดสูงและขนาดเล็ก ตลอดจนเมื่อปรับขนาดโดยเบราว์เซอร์
150x150 | 150x150&สเกล=2 |
---|---|
![]() |
![]() |
รูปภาพดังกล่าวจะทำงานได้ดีในเบราว์เซอร์ในเดสก์ท็อป เมื่อแทรกลงในแท็ก img
หรือ div
โดยกำหนดความสูงและความกว้างโดยใช้ CSS เบราว์เซอร์จะลดขนาดรูปภาพเป็นขนาดที่ถูกต้องโดยไม่สูญเสียคุณภาพของภาพ
ตารางนี้แสดงคำขอรูปภาพที่แตกต่างกันสามรายการ
- ภาพแรกใช้สำหรับรูปภาพขนาด 100x100 ซึ่งไม่มีการระบุค่าขนาด โดยจะแสดงได้อย่างถูกต้องในเดสก์ท็อป แต่เล็กเกินกว่าที่จะอ่านในอุปกรณ์เคลื่อนที่ได้
- กฎข้อที่ 2 จะเพิ่มขนาดแผนที่เป็น 2 เท่า ในเดสก์ท็อป CSS จะพอดีกับองค์ประกอบ
img
ขนาด 100x100 ที่ระบุไว้ แต่เมื่อลดขนาดรูปภาพ ถนนและป้ายกำกับจะเล็กเกินไป ในอุปกรณ์เคลื่อนที่ รูปภาพมีขนาดที่ถูกต้อง แต่อ่านไม่ออกว่าถนนและป้ายกำกับอ่านไม่ออก - คำขอที่ 3 เป็นคำขอสำหรับแผนที่ขนาด 100x100 ที่มี
scale=2
รูปภาพจะแสดงโดยมีรายละเอียด 200 พิกเซล เดสก์ท็อปจะลดขนาดลงอย่างสมบูรณ์แบบจนแยกความแตกต่างจากคำขอขนาด 100x100 ก่อนหน้านี้ไม่ได้ ในขณะที่เบราว์เซอร์ในอุปกรณ์เคลื่อนที่ได้รับประโยชน์จากความละเอียดเพิ่มเติมที่ API แสดง
คำขอรูปภาพ | |||
---|---|---|---|
อุปกรณ์ | 100x100 |
200x200 |
100x100&scale=2 |
เดสก์ท็อป (มี height="100px" และwidth="100px" ในแท็กimg ) |
![]() |
![]() |
![]() |
ความละเอียดสูง (จำลอง) |
![]() |
![]() |
![]() |
สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการพัฒนาสำหรับอุปกรณ์เคลื่อนที่และจอแสดงผลความละเอียดสูง ขอแนะนำให้อ่านข้อมูลต่อไปนี้
- การรองรับหน้าจอหลายขนาดในเอกสารประกอบสําหรับนักพัฒนาซอฟต์แวร์ Android
- คำแนะนำของ Webkit.org สำหรับการพัฒนาเว็บไซต์แบบ DPI สูง
- การรองรับหน้าจอความละเอียดสูงในไลบรารีของนักพัฒนาซอฟต์แวร์ iOS
รูปแบบรูปภาพ
คุณแสดงผลรูปภาพในรูปแบบกราฟิกบนเว็บที่ใช้กันทั่วไปได้หลายรูปแบบ ได้แก่ GIF,
JPEG และ PNG พารามิเตอร์ format
จะใช้ค่าใดค่าหนึ่งต่อไปนี้
png8
หรือpng
(ค่าเริ่มต้น) ระบุรูปแบบ PNG 8 บิตpng32
ระบุรูปแบบ PNG 32 บิตgif
ระบุรูปแบบ GIFjpg
ระบุรูปแบบการบีบอัด JPEGjpg-baseline
ระบุรูปแบบการบีบอัด JPEG แบบไม่ก้าวหน้า
ตัวอย่างเหล่านี้จะขอแมปในรูปแบบ gif
และ png
https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&format=gif&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&format=png&&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
jpg
และ jpg-baseline
มักจะมีขนาดรูปภาพขนาดเล็กที่สุด แต่ใช้การบีบอัดแบบ "สูญเสีย" ซึ่งอาจทำให้รูปภาพลดลงได้ gif
, png8
และ png32
มีการบีบอัดแบบไม่สูญเสียข้อมูล
รูปภาพ JPEG ส่วนใหญ่เป็นแบบโพรเกรสซีฟ ซึ่งหมายความว่ารูปภาพจะโหลดขนาดหยาบก่อนหน้านั้นและปรับความละเอียดของรูปภาพเมื่อมีข้อมูลมากขึ้น วิธีนี้จะช่วยให้โหลดรูปภาพในหน้าเว็บได้อย่างรวดเร็วและเป็น JPEG ที่ใช้กันอย่างแพร่หลายในปัจจุบัน อย่างไรก็ตาม การใช้งาน JPEG บางอย่างต้องใช้รูปภาพที่ไม่โปรเกรสซีฟ (พื้นฐาน) ในกรณีดังกล่าว คุณอาจต้องใช้รูปแบบ jpg-baseline
ซึ่งเป็นแบบไม่โพรเกรสซีฟ
ประเภทแผนที่
Maps Static API สร้างแผนที่ในหลายรูปแบบตามรายการด้านล่าง
roadmap
(ค่าเริ่มต้น) ระบุรูปภาพแผนกลยุทธ์มาตรฐานตามที่แสดงในเว็บไซต์ Google Maps ตามปกติ หากไม่ได้ระบุค่าmaptype
Maps Static API จะแสดงการ์ดroadmap
โดยค่าเริ่มต้นsatellite
ระบุภาพถ่ายดาวเทียมterrain
ระบุรูปภาพแผนที่แบบนูนขึ้นมาจริง ซึ่งแสดงภูมิประเทศและพืชพรรณhybrid
ระบุถึงการผสมระหว่างภาพถ่ายดาวเทียมและแผนกลยุทธ์ ซึ่งแสดงเลเยอร์ถนนหลักและชื่อสถานที่แบบโปร่งใสในภาพถ่ายดาวเทียม
คุณดูความแตกต่างระหว่างแผนกลยุทธ์และประเภทภูมิประเทศได้ในตัวอย่างโค้ดนี้
https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=roadmap&key=YOUR_API_KEY&signature=YOUR_SIGNATURE https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=terrain&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
แผนที่แบบผสมใช้ภาพถ่ายจากดาวเทียมและฟีเจอร์แผนกลยุทธ์ที่โดดเด่นเพื่อสร้างแผนที่รวม ตัวอย่างต่อไปนี้แสดงประเภทแผนที่ดาวเทียมและแบบผสม
https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=satellite&key=YOUR_API_KEY&signature=YOUR_SIGNATURE https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=hybrid&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
แผนที่ที่มีการจัดรูปแบบ
ปรับแต่งการนำเสนอแผนที่ของ Google มาตรฐานโดยใช้รูปแบบของคุณเอง ดูคู่มือแผนที่ที่มีการจัดรูปแบบ
ตัวทำเครื่องหมาย
พารามิเตอร์ markers
กำหนดชุดของตัวทำเครื่องหมายอย่างน้อย 1 ตัว (หมุดแผนที่) ที่ชุดสถานที่ เครื่องหมายแต่ละอันที่กำหนดภายในการประกาศ markers
รายการเดียวต้องแสดงรูปแบบภาพเดียวกัน หากต้องการแสดงเครื่องหมายที่มีสไตล์ต่างกัน คุณจะต้องระบุพารามิเตอร์ markers
หลายรายการที่มีข้อมูลรูปแบบแยกกัน
พารามิเตอร์ markers
จะใช้ชุดของการกำหนดค่า (ตัวบ่งชี้ของเครื่องหมาย) ของรูปแบบต่อไปนี้
markers=markerStyles|markerLocation1|
markerLocation2|...
ฯลฯ
ชุดของ markerStyles จะประกาศที่จุดเริ่มต้นของการประกาศ markers
และประกอบด้วยตัวบ่งชี้รูปแบบ 0 หรือมากกว่าซึ่งคั่นด้วยอักขระไปป์ (|
) ตามด้วยชุดตำแหน่งอย่างน้อย 1 แห่งที่คั่นด้วยอักขระไปป์ (|
)
เนื่องจากทั้งข้อมูลรูปแบบและข้อมูลสถานที่ถูกคั่นด้วยอักขระไปป์ ข้อมูลรูปแบบต้องปรากฏก่อนในคำอธิบายเครื่องหมาย เมื่อเซิร์ฟเวอร์ Maps Static API พบตำแหน่งในข้อบ่งชี้เครื่องหมาย พารามิเตอร์ตัวทำเครื่องหมายอื่นๆ ทั้งหมดจะถือเป็นตำแหน่งเช่นกัน
รูปแบบตัวทำเครื่องหมาย
ชุดของตัวบอกรูปแบบเครื่องหมายคือชุดของการกำหนดค่า
ที่คั่นด้วยอักขระไปป์ (|
) โดยข้อบ่งชี้สไตล์นี้จะกำหนดแอตทริบิวต์ภาพที่จะใช้เมื่อแสดงเครื่องหมายภายในข้อบ่งชี้เครื่องหมายนี้ คำอธิบายรูปแบบเหล่านี้มีการกําหนดคีย์/ค่าต่อไปนี้
size:
(ไม่บังคับ) ระบุขนาดของเครื่องหมายจากชุด{tiny, mid, small}
หากไม่มีการตั้งค่าพารามิเตอร์size
ไว้ ตัวทำเครื่องหมายจะปรากฏในขนาดเริ่มต้น (ปกติ)color:
(ไม่บังคับ) ระบุสี 24 บิต (เช่นcolor=0xFFFFCC
) หรือสีที่กำหนดไว้ล่วงหน้าจากชุด{black, brown, green, purple, yellow, blue, gray, orange, red, white}
โปรดทราบว่าตัวทำเครื่องหมายไม่รองรับความโปร่งแสง (ระบุโดยใช้ค่าสีฐานสิบหก 32 บิต) ในเครื่องหมาย แม้ว่าจะมีการรองรับเส้นทางก็ตาม
label:
(ไม่บังคับ) ระบุอักขระที่เป็นตัวอักษรและตัวเลขคละกันตัวพิมพ์ใหญ่ 1 ตัวจากชุด {A-Z, 0-9} (ข้อกำหนดสำหรับอักขระตัวพิมพ์ใหญ่เป็นข้อกำหนดใหม่ใน API เวอร์ชันนี้) โปรดทราบว่าตัวทำเครื่องหมายขนาดเริ่มต้นและmid
เป็นเครื่องหมายเพียงตัวเดียว ที่แสดงพารามิเตอร์alphanumeric-character
ได้ เครื่องหมายtiny
และsmall
ไม่สามารถแสดงอักขระที่เป็นตัวอักษรและตัวเลขคละกัน
การปรับขนาดเครื่องหมาย
ค่า scale
จะคูณด้วยขนาดภาพของเครื่องหมายเพื่อให้ได้ขนาดเอาต์พุตจริงของเครื่องหมายเป็นพิกเซล ค่าสเกลเริ่มต้นคือ 1 ค่าที่ยอมรับคือ 1, 2 และ 4
ขีดจำกัดขนาดพิกเซลในรูปภาพจะมีผลหลังจากที่ใช้การปรับขนาด ตัวอย่างเช่น หากตั้งค่าตัวทำเครื่องหมายเป็น scale:2
เครื่องหมายอาจมีขนาดใหญ่กว่าขนาดสูงสุด 4,096 พิกเซล ตราบใดที่เครื่องหมายนั้นลดลงเหลือน้อยกว่า 4,096 พิกเซล ใช้การปรับสเกลของเครื่องหมายร่วมกับการปรับขนาดแผนที่เมื่อแสดงแผนที่ที่มีความละเอียดสูง
ตำแหน่งของเครื่องหมายระบุตำแหน่ง
ตัวบอกเครื่องหมายแต่ละตัวต้องมีชุดของตำแหน่งอย่างน้อยหนึ่งตำแหน่งที่ระบุ
ตำแหน่งที่จะวางเครื่องหมายบนแผนที่ สถานที่เหล่านี้อาจระบุเป็นค่าละติจูด/ลองจิจูดหรือเป็นที่อยู่ก็ได้ ตำแหน่งเหล่านี้ถูกคั่นด้วยอักขระไปป์ (|
)
หมายเหตุ: หากคุณเลือกระบุตำแหน่งของเครื่องหมายโดยใช้วิธีที่ต้องมีการระบุพิกัดทางภูมิศาสตร์ เช่น สตริงที่อยู่หรือโพลีไลน์ที่มนุษย์อ่านได้ คำขอจะมีตัวทำเครื่องหมายได้ไม่เกิน 15 ตัว ขีดจำกัดนี้ใช้กับตำแหน่งเครื่องหมายที่ต้องมีการระบุพิกัดทางภูมิศาสตร์เท่านั้น แต่จะไม่ใช้กับตำแหน่งของเครื่องหมายที่ระบุด้วยพิกัดละติจูด/ลองจิจูด
พารามิเตอร์ตำแหน่งจะระบุตำแหน่งของเครื่องหมายบนแผนที่ หากตำแหน่งไม่ได้อยู่ในแผนที่ เครื่องหมายนั้นจะไม่ปรากฏในรูปภาพที่สร้างขึ้น ถ้าต้องมีการส่งพารามิเตอร์ center
และ zoom
อย่างไรก็ตาม ถ้าไม่ได้ให้พารามิเตอร์เหล่านี้ไว้ เซิร์ฟเวอร์ Maps Static API จะสร้างรูปภาพซึ่งมีเครื่องหมายที่จัดเตรียมไว้ให้โดยอัตโนมัติ
(โปรดดูการกำหนดตำแหน่งโดยนัย)
ตัวอย่างการประกาศเครื่องหมายจะแสดงที่นี่ โปรดทราบว่าเรากำหนดรูปแบบ 1 ชุด และตำแหน่ง 3 ตำแหน่ง ได้แก่
https://maps.googleapis.com/maps/api/staticmap?center=Williamsburg,Brooklyn,NY&zoom=13&size=400x400&
markers=color:blue%7Clabel:S%7C11211%7C11206%7C11222&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
หากต้องการกำหนดตัวทำเครื่องหมายที่มีรูปแบบแตกต่างกัน เราต้องใส่พารามิเตอร์ markers
หลายรายการ พารามิเตอร์ markers
ชุดนี้จะกำหนดตัวทำเครื่องหมาย 3 ตัว ได้แก่ ตัวทำเครื่องหมายสีน้ำเงินที่มีป้ายกำกับว่า "S" ที่ 62.107733, -145.5419
ตัวทำเครื่องหมายสีเขียวเล็กๆ 1 ตัวที่ "Delta Junction, AK" และตัวทำเครื่องหมายสีเหลืองขนาดกลาง 1 ตัวซึ่งติดป้ายกำกับว่า "C" ที่ "Tok, AK" เครื่องหมายเหล่านี้จะแสดงอยู่ในตัวอย่างนี้
https://maps.googleapis.com/maps/api/staticmap?center=63.259591,-144.667969&zoom=6&size=400x400
&markers=color:blue%7Clabel:S%7C62.107733,-145.541936&markers=size:tiny%7Ccolor:green%7CDelta+Junction,AK
&markers=size:mid%7Ccolor:0xFFFF00%7Clabel:C%7CTok,AK"&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
ไอคอนที่กำหนดเอง
แทนที่จะใช้ไอคอนตัวทำเครื่องหมายของ Google คุณสามารถใช้ไอคอนที่กำหนดเองแทนได้ ไอคอนที่กำหนดเองจะมีการระบุโดยใช้ตัวบ่งชี้ icon
ในพารามิเตอร์ markers
เช่น
markers=icon:URLofIcon|markerLocation
ระบุ icon
โดยใช้ URL (ซึ่งควรเข้ารหัส URL) คุณใช้ URL ที่สร้างโดยบริการย่อ URL เช่น https://goo.gl
ได้ บริการย่อ URL ส่วนใหญ่ใช้ประโยชน์จากการเข้ารหัส URL โดยอัตโนมัติ
คุณสามารถระบุจุดยึดสำหรับไอคอนที่กำหนดเอง จุดยึดจะกำหนดวิธีวางไอคอนโดยสัมพันธ์กับตำแหน่ง markers
ที่ระบุ โดยค่าเริ่มต้น จุดยึดของไอคอนที่กำหนดเองจะอยู่ที่ตรงกลางด้านล่างของรูปภาพไอคอน คุณระบุจุดยึดอื่นได้โดยใช้ตัวบ่งชี้ anchor
ร่วมกับ icon
กำหนด anchor
เป็นจุด x,y ของไอคอน (เช่น
10,5
) หรือเป็นการจัดแนวที่กำหนดไว้ล่วงหน้าโดยใช้ค่าใดค่าหนึ่งต่อไปนี้
top
, bottom
, left
, right
,
center
, topleft
, topright
, bottomleft
หรือ
bottomright
เช่น
markers=anchor:bottomright|icon:URLofIcon|markerLocation1|markerLocation2
คุณใช้ไอคอนที่กำหนดเองแบบไม่ซ้ำกันได้สูงสุด 5 ไอคอนต่อคำขอ ข้อจำกัดนี้ไม่ได้หมายความว่าคุณถูกจำกัดตำแหน่งบนแผนที่แค่ 5 ตำแหน่ง ไอคอนที่ไม่ซ้ำกันแต่ละไอคอนอาจใช้กับตำแหน่ง markers
มากกว่า 1 ตำแหน่งบนแผนที่ของคุณ
รูปแบบไอคอน:
- ภาพไอคอนอาจอยู่ในรูปแบบ PNG, JPEG หรือ GIF แต่แนะนำให้ใช้ PNG
- ไอคอนมีขนาดสูงสุดได้ถึง 4096 พิกเซล (64x64 สำหรับภาพสี่เหลี่ยมจัตุรัส)
ตัวอย่างไอคอนที่กำหนดเอง
ตัวอย่างที่ 1 จะสร้างไอคอนที่กำหนดเองและจัดตำแหน่งของไอคอนโดยใช้แท็ก Anchor
https://maps.googleapis.com/maps/api/staticmap?&size=600x400&style=visibility:on
&style=feature:water%7Celement:geometry%7Cvisibility:on
&style=feature:landscape%7Celement:geometry%7Cvisibility:on
&markers=anchor:32,10%7Cicon:https://goo.gl/5y3S82%7CCanberra+ACT
&markers=anchor:topleft%7Cicon:http://tinyurl.com/jrhlvu6%7CMelbourne+VIC
&markers=anchor:topright%7Cicon:https://goo.gl/1oTJ9Y%7CSydney+NSW&key=YOUR_API_KEY
&signature=YOUR_SIGNATURE
ตัวอย่างที่ 2 สร้างไอคอนที่กำหนดเองเหมือนกับตัวอย่างที่ 1 แต่ไม่ได้ตั้งค่าตำแหน่งของไอคอนโดยใช้ Anchor โดยใช้ Anchor เริ่มต้นของตรงกลางด้านล่าง
https://maps.googleapis.com/maps/api/staticmap?&size=600x400&style=visibility:on
&style=feature:water%7Celement:geometry%7Cvisibility:on
&style=feature:landscape%7Celement:geometry%7Cvisibility:on
&markers=icon:https://goo.gl/5y3S82%7CCanberra+ACT
&markers=icon:http://tinyurl.com/jrhlvu6%7CMelbourne+VIC
&markers=icon:https://goo.gl/1oTJ9Y%7CSydney+NSW&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
เส้นทาง Maps Static API
พารามิเตอร์ path
กำหนดชุดของสถานที่ตั้งอย่างน้อย 1 แห่งที่เชื่อมต่อด้วยเส้นทางที่วางซ้อนบนรูปภาพแผนที่ พารามิเตอร์ path
จะใช้ชุดของการกำหนดค่า (path ข้อบ่งชี้) ของรูปแบบต่อไปนี้
path=pathStyles|pathLocation1|pathLocation2|...
ฯลฯ
โปรดทราบว่าจุดเส้นทางทั้ง 2 จุดจะคั่นด้วยอักขระไปป์ (|
) เนื่องจากทั้งข้อมูลรูปแบบและข้อมูลจุดถูกคั่นด้วยอักขระไปป์ ข้อมูลรูปแบบต้องปรากฏเป็นอันดับแรกในข้อบ่งชี้เส้นทางทั้งหมด เมื่อเซิร์ฟเวอร์ Maps Static API พบตำแหน่งในตัวบ่งชี้เส้นทาง พารามิเตอร์เส้นทางอื่นๆ ทั้งหมดจะถือเป็นตำแหน่งเช่นกัน
รูปแบบเส้นทาง
ชุดของตัวบอกรูปแบบเส้นทางคือชุดของการกำหนดค่า
ที่คั่นด้วยอักขระไปป์ (|
) โดยสไตล์ข้อนี้จะกำหนดแอตทริบิวต์ภาพที่จะใช้เมื่อแสดงเส้นทาง คำอธิบายรูปแบบเหล่านี้มีการกําหนดคีย์/ค่าต่อไปนี้
weight:
(ไม่บังคับ) ระบุความหนาของเส้นทางเป็นพิกเซล หากไม่ได้ตั้งค่าพารามิเตอร์weight
ไว้ เส้นทางจะปรากฏในความหนาเริ่มต้น (5 พิกเซล)color:
(ไม่บังคับ) ระบุสีเป็น 24 บิต (เช่นcolor=0xFFFFCC
) หรือค่าเลขฐาน 16 32 บิต (เช่นcolor=0xFFFFCCFF
) หรือจากชุด{black, brown, green, purple, yellow, blue, gray, orange, red, white}
เมื่อระบุค่าฐานสิบหก 32 บิต อักขระ 2 ตัวสุดท้ายจะระบุค่าความโปร่งใสของอัลฟ่า 8 บิต ค่านี้จะแตกต่างกันระหว่าง
00
(แบบโปร่งใสทั้งหมด) และFF
(ทึบแสงสนิท) โปรดทราบว่าความโปร่งแสงได้รับการสนับสนุนในเส้นทาง แม้ว่าจะไม่มีการสนับสนุนสำหรับเครื่องหมายfillcolor:
(ไม่บังคับ) ระบุทั้งว่าเส้นทางนั้น ทำเครื่องหมายออกจากพื้นที่รูปหลายเหลี่ยม และระบุสีเติมที่จะใช้เป็นการวางซ้อน ภายในพื้นที่นั้น ชุดสถานที่ต่อไปนี้ไม่จำเป็นต้องเป็นลูป "ปิด" เนื่องจากเซิร์ฟเวอร์ Maps Static API จะรวมจุดแรกและจุดสุดท้ายเข้าด้วยกันโดยอัตโนมัติ อย่างไรก็ตาม โปรดทราบว่าเส้นโครงร่างด้านนอกของบริเวณที่เติมสีจะไม่ปิดไป เว้นแต่คุณจะระบุตําแหน่งเริ่มต้นและจุดสิ้นสุดเดียวกันไว้โดยเฉพาะgeodesic:
(ไม่บังคับ) บ่งบอกว่าเส้นทางที่ขอควรตีความว่าเป็นเส้นทางภูมิศาสตร์ที่ไปตามส่วนโค้งของโลก เมื่อเป็นเท็จ เส้นทางจะแสดงผลเป็นเส้นตรงในพื้นที่หน้าจอ ค่าเริ่มต้นคือ false
ตัวอย่างคำจำกัดความของเส้นทาง
- เส้นบางๆ สีฟ้า ความทึบแสง 50%:
path=color:0x0000ff80|weight:1
- เส้นทึบสีแดง:
path=color:0xff0000ff|weight:5
- เส้นหนาสีขาว:
path=color:0xffffffff|weight:10
รูปแบบเส้นทางเหล่านี้เป็นแบบไม่บังคับ หากต้องการแอตทริบิวต์เริ่มต้น คุณอาจข้ามการกำหนดแอตทริบิวต์ของเส้นทาง ในกรณีนั้น "อาร์กิวเมนต์" แรกของตัวบอกเส้นทางจะปรากฏแทนจุดแรกที่ประกาศไว้ (ตำแหน่ง)
จุดบนเส้นทาง
หากต้องการวาดเส้นทาง พารามิเตอร์ path
จะต้องส่งผ่านจุด 2 จุดขึ้นไปด้วย จากนั้น Maps Static API จะเชื่อมต่อเส้นทาง
ตามจุดเหล่านั้น ตามลำดับที่ระบุ pathPoint แต่ละรายการจะแสดงไว้ใน pathDescriptor ที่คั่นด้วยอักขระ |
(ไปป์)
ตัวอย่างต่อไปนี้กำหนดเส้นทางสีน้ำเงินที่มีความทึบแสง 50% จาก ยูเนียนสแควร์ นิวยอร์กไปยังไทม์สแควร์ รัฐนิวยอร์ก
ข้อมูลจำเพาะของพารามิเตอร์ path
มีดังนี้
path=color:0x0000ff|weight:5|40.737102,-73.990318|40.749825,-73.987963|40.752946,-73.987384|40.755823,-73.986397
ตัวอย่างต่อไปนี้จะกำหนดเส้นทางเดียวกันแทนที่จะกำหนดเส้นสีแดงทึบที่มีความทึบแสง 100%
ข้อมูลจำเพาะของพารามิเตอร์ path
นี้คือ
path=color:0xff0000ff|weight:5|40.737102,-73.990318|40.749825,-73.987963|40.752946,-73.987384|40.755823,-73.986397
ตัวอย่างถัดไปกำหนดพื้นที่รูปหลายเหลี่ยมภายในแมนฮัตตัน แล้วส่งทางแยกเป็นหลายทางในสถานที่
ข้อมูลจำเพาะของพารามิเตอร์ path
นี้คือ
path=color:0x00000000|weight:5|fillcolor:0xFFFF0033|8th+Avenue+%26+34th+St,New+York,NY|\ 8th+Avenue+%26+42nd+St,New+York,NY|Park+Ave+%26+42nd+St,New+York,NY,NY|\ Park+Ave+%26+34th+St,New+York,NY,NY
โปรดทราบว่าเรากำหนดให้เส้นทางมองไม่เห็นและพื้นที่รูปหลายเหลี่ยมให้มีความทึบแสง 15%
โพลีไลน์ที่เข้ารหัส
คุณประกาศเส้นทางเป็นโพลีไลน์ที่เข้ารหัสแทนชุดสถานที่ตั้งได้โดยใช้คำนำหน้า enc:
ภายในการประกาศสถานที่ตั้งของ path
ตัวอย่างต่อไปนี้สรุปเส้นทางของทางหลวงอะแลสกาจากดอว์สันครีก (BC) จนถึงย่านเดลต้า (AK) ที่มีเส้นประกอบที่เข้ารหัส
https://maps.googleapis.com/maps/api/staticmap
?size=400x400¢er=59.900503,-135.478011&zoom=4
&path=weight:3%7Ccolor:orange%7Cenc:_fisIp~u%7CU}%7Ca@pytA_~b@hhCyhS~hResU%7C%7Cx@oig@rwg@amUfbjA}f[roaAynd@%7CvXxiAt{ZwdUfbjAewYrqGchH~vXkqnAria@c_o@inc@k{g@i`]o%7CF}vXaj\h`]ovs@?yi_@rcAgtO%7Cj_AyaJren@nzQrst@zuYh`]v%7CGbldEuzd@%7C%7Cx@spD%7CtrAzwP%7Cd_@yiB~vXmlWhdPez\_{Km_`@~re@ew^rcAeu_@zhyByjPrst@ttGren@aeNhoFemKrvdAuvVidPwbVr~j@or@f_z@ftHr{ZlwBrvdAmtHrmT{rOt{Zz}E%7Cc%7C@o%7CLpn~AgfRpxqBfoVz_iAocAhrVjr@rh~@jzKhjp@``NrfQpcHrb^k%7CDh_z@nwB%7Ckb@a{R%7Cyh@uyZ%7CllByuZpzw@wbd@rh~@%7C%7CFhqs@teTztrAupHhyY}t]huf@e%7CFria@o}GfezAkdW%7C}[ocMt_Neq@ren@e~Ika@pgE%7Ci%7CAfiQ%7C`l@uoJrvdAgq@fppAsjGhg`@%7ChQpg{Ai_V%7C%7Cx@mkHhyYsdP%7CxeA~gF%7C}[mv`@t_NitSfjp@c}Mhg`@sbChyYq}e@rwg@atFff}@ghN~zKybk@fl}A}cPftcAite@tmT__Lha@u~DrfQi}MhkSqyWivIumCria@ciO_tHifm@fl}A{rc@fbjAqvg@rrqAcjCf%7Ci@mqJtb^s%7C@fbjA{wDfs`BmvEfqs@umWt_Nwn^pen@qiBr`xAcvMr{Zidg@dtjDkbM%7Cd_@
&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
เช่นเดียวกับเส้นทางมาตรฐาน เส้นทางโพลีไลน์ที่เข้ารหัสอาจแบ่งพื้นที่รูปหลายเหลี่ยม หากมีการส่งต่ออาร์กิวเมนต์ fillcolor
ไปยังพารามิเตอร์ path
ตัวอย่างต่อไปนี้แสดงพื้นที่รูปหลายเหลี่ยมสำหรับบรุกลิน นิวยอร์ก
https://maps.googleapis.com/maps/api/staticmap
?size=400x400¢er=40.653279,-73.959816&zoom=11
&path=fillcolor:0xAA000033%7Ccolor:0xFFFFFF00%7Cenc:}zswFtikbMjJzZ%7CRdPfZ}DxWvBjWpF~IvJnEvBrMvIvUpGtQpFhOQdKpz@bIx{A%7CPfYlvApz@bl@tcAdTpGpVwQtX}i@%7CGen@lCeAda@bjA%60q@v}@rfAbjA%7CEwBpbAd_@he@hDbu@uIzWcWtZoTdImTdIwu@tDaOXw_@fc@st@~VgQ%7C[uPzNtA%60LlEvHiYyLs^nPhCpG}SzCNwHpz@cEvXg@bWdG%60]lL~MdTmEnCwJ[iJhOae@nCm[%60Aq]qE_pAaNiyBuDurAuB }}Ay%60@%7CEKv_@?%7C[qGji@lAhYyH%60@Xiw@tBerAs@q]jHohAYkSmW?aNoaAbR}LnPqNtMtIbRyRuDef@eT_z@mW_Nm%7CB~j@zC~hAyUyJ_U{Z??cPvg@}s@sHsc@_z@cj@kp@YePoNyYyb@_iAyb@gBw^bOokArcA}GwJuzBre@i\tf@sZnd@oElb@hStW{]vv@??kz@~vAcj@zKa%60Atf@uQj_Aee@pU_UrcA
&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
วิวพอร์ต
รูปภาพอาจระบุ วิวพอร์ต โดยการระบุตำแหน่งที่มองเห็นได้โดยใช้พารามิเตอร์ visible
พารามิเตอร์ visible
จะสั่งให้บริการ Maps Static API สร้างแผนที่ให้ตำแหน่งที่มีอยู่ยังคงมองเห็นได้ (พารามิเตอร์นี้สามารถรวมกับเครื่องหมายหรือเส้นทางที่มีอยู่เพื่อกำหนดพื้นที่ที่มองเห็นได้ด้วย) การกำหนดวิวพอร์ตในลักษณะนี้จะลดความจำเป็นในการระบุระดับการซูมที่แน่นอน
ตัวอย่างถัดไปขอแผนที่ซึ่งมีศูนย์กลางอยู่ที่เมืองบอสตัน รัฐแมสซาชูเซตส์ ซึ่งมีทั้ง MIT และจัตุรัสฮาร์วาร์ดในเคมบริดจ์ รัฐแมสซาชูเซตส์:
https://maps.googleapis.com/maps/api/staticmap?center=Boston,MA
&visible=77+Massachusetts+Ave,Cambridge,MA%7CHarvard+Square,Cambridge,MA&size=512x512&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
การกำหนดตำแหน่งบนแผนที่โดยนัย
ปกติคุณต้องระบุพารามิเตอร์ URL center
และ zoom
เพื่อกำหนดตำแหน่งและระดับการซูมของแผนที่ที่คุณสร้างขึ้น
อย่างไรก็ตาม หากคุณใส่พารามิเตอร์ markers
, path
หรือ
visible
คุณสามารถให้ Maps Static API กำหนดจุดศูนย์กลางและระดับการซูมที่ถูกต้องโดยปริยาย โดยพิจารณาจากการประเมินตำแหน่งขององค์ประกอบเหล่านี้
หากใส่องค์ประกอบตั้งแต่ 2 องค์ประกอบขึ้นไป Maps Static API จะกำหนดจุดศูนย์กลางและระดับการซูมที่เหมาะสม ให้พื้นที่เพิ่มเติมสำหรับองค์ประกอบที่มีอยู่ ตัวอย่างนี้แสดงแผนที่ที่ประกอบด้วยซานฟรานซิสโก โอกแลนด์ และซานโฮเซ แคลิฟอร์เนีย
https://maps.googleapis.com/maps/api/staticmap?size=512x512&maptype=roadmap\
&markers=size:mid%7Ccolor:red%7CSan+Francisco,CA%7COakland,CA%7CSan+Jose,CA&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
ขนาดรูปภาพใหญ่ขึ้น
หากต้องการรูปภาพที่มีขนาดใหญ่กว่า 640 x 640 พิกเซล (หรือ 1280 x 1280 พิกเซลซึ่งมีค่าสเกล 2) โปรด ติดต่อทีมสนับสนุนและแจ้งข้อมูลต่อไปนี้
- กรณีการใช้งานและเหตุผลที่คุณต้องการรูปภาพขนาดใหญ่
- ไม่ว่าคุณจะพิจารณาใช้ Google Maps Platform API อื่นๆ (Maps JavaScript API, Maps Embed API, Maps SDK สำหรับ Android หรือ Maps SDK สำหรับ iOS) และเหตุผล เหล่านั้นไม่ตรงกับความต้องการของคุณ
- ภาพหน้าจอ การจำลอง หรือตัวอย่างวิธีที่คุณจะใช้รูปภาพขนาดใหญ่
- การใช้งานรายเดือนโดยประมาณสำหรับรูปภาพขนาดใหญ่
เราจะตรวจสอบคำขอโดยอิงตามข้อมูลที่คุณให้ไว้ และพิจารณาว่า Use Case ของคุณเป็นไปตามข้อกำหนดในการให้บริการของ Google Maps Platform หรือไม่
ขนาดสูงสุดที่ใช้ได้คือ 2048 x 2048 พิกเซล
การแก้ไขปัญหาและการสนับสนุน
ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้ Maps Static API ได้ที่หน้าการสนับสนุน
Maps Static API อาจแสดงข้อผิดพลาดหรือคําเตือนเมื่อเกิดข้อผิดพลาด คุณควรตรวจหาคำเตือนโดยเฉพาะหากสังเกตเห็นว่ามีบางอย่างหายไปจากแผนที่ และควรตรวจสอบคำเตือนก่อนที่จะเปิดแอปพลิเคชันใหม่ด้วย โปรดทราบว่าคำเตือนอาจไม่ปรากฏในทันทีเนื่องจากคำเตือนจะปรากฏในส่วนหัวของ HTTP ดูข้อมูลเพิ่มเติมได้ในคู่มือเกี่ยวกับข้อผิดพลาดและคำเตือน