หน้านี้ได้รับการแปลโดย Cloud Translation API

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

บทนำ

Maps Static API จะแสดงรูปภาพ (GIF, PNG หรือ JPEG) เพื่อตอบกลับคําขอ HTTP ผ่าน URL สําหรับคําขอแต่ละรายการ คุณสามารถระบุตําแหน่งของแผนที่, ขนาดของรูปภาพ, ระดับการซูม, ประเภทของแผนที่ และตําแหน่งของเครื่องหมายที่ไม่บังคับในตําแหน่งบนแผนที่ คุณยังติดป้ายกํากับเครื่องหมายโดยใช้อักขระที่เป็นตัวอักษรและตัวเลขคละกันได้ด้วย

รูปภาพ API แบบคงที่ของ Maps จะฝังอยู่ในแอตทริบิวต์ src ของแท็ก <img> หรือเทียบเท่าในภาษาโปรแกรมอื่นๆ

เอกสารนี้อธิบายรูปแบบที่จําเป็นของ URL ของ Maps Static API และพารามิเตอร์ที่ใช้ได้ นอกจากนี้ยังแนะนํากลเม็ดเคล็ดลับบางอย่างในการระบุ URL ของคุณ

ก่อนเริ่มต้น

เอกสารนี้มีไว้สําหรับนักพัฒนาเว็บไซต์และอุปกรณ์เคลื่อนที่ที่ต้องการใส่รูปภาพ API แบบคงที่ของ Maps ไว้ในหน้าเว็บหรือแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ โดยจะแนะนําวิธีใช้ 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 พารามิเตอร์ทั้งหมดจะแยกกันโดยใช้อักขระเครื่องหมายแอมเพอร์แซนด์ (&) รายการพารามิเตอร์และค่าที่เป็นไปได้จะมีการแจกแจงในเอกสารนี้

สําคัญ: การสนทนาเกี่ยวกับพารามิเตอร์ของ URL ใช้ตัวอย่างความชัดเจนเพื่อระบุไว้ในแบบฟอร์มการ Escape ล่วงหน้า ก่อนที่จะส่งคําขอไปยัง API พารามิเตอร์ดังกล่าวควรมีการเข้ารหัส URL อย่างถูกต้อง เช่น พารามิเตอร์จํานวนมากใช้อักขระไปป์ (|) เป็นตัวคั่น ซึ่งควรเข้ารหัสเป็น %7C ใน URL สุดท้าย เช่นในตัวอย่างด่วนที่ด้านบนของเอกสารนี้ หากต้องการข้อมูลเพิ่มเติม โปรดดู การสร้าง URL ที่ถูกต้อง

Maps Static API จะกําหนดรูปภาพแผนที่โดยใช้พารามิเตอร์ของ URL ต่อไปนี้

พารามิเตอร์สถานที่ตั้ง

center (ต้องระบุหากไม่มีเครื่องหมาย) ระบุกึ่งกลางแผนที่ ซึ่งเท่ากับขอบทั้งหมดของแผนที่ พารามิเตอร์นี้ใช้สถานที่ตั้งเป็นคู่ {ละติจูด,longitude} ที่คั่นด้วยคอมมา (เช่น "40.714728,-73.998672") หรือที่อยู่สตริง (เช่น "city hll, new york, ny") ที่ระบุสถานที่ตั้งที่ไม่ซ้ําบนใบหน้าของโลก ดูข้อมูลเพิ่มเติมได้ที่สถานที่ตั้ง
zoom (จําเป็นหากไม่มีเครื่องหมาย) จะกําหนดระดับการซูมของแผนที่ซึ่งกําหนดระดับการขยายของแผนที่ พารามิเตอร์นี้ใช้ค่าตัวเลขที่สอดคล้องกับระดับการซูมของภูมิภาคที่ต้องการ ดูข้อมูลเพิ่มเติมได้ที่ระดับการซูม

พารามิเตอร์แผนที่

size (จําเป็น) กําหนดขนาดสี่เหลี่ยมผืนผ้าของรูปภาพแผนที่ พารามิเตอร์นี้ใช้สตริงของรูปแบบ {horizontal_value}x{vertical_value} เช่น 500x400 จะกําหนดแผนที่ขนาด 500 พิกเซล x สูง 400 พิกเซล Maps ที่มีขนาดเล็กกว่า 180 พิกเซลจะแสดงโลโก้ Google ที่ลดขนาดลง พารามิเตอร์นี้ได้รับผลกระทบจากพารามิเตอร์ scale ขนาดเอาต์พุตสุดท้ายเป็นผลิตภัณฑ์ของขนาดและขนาดค่า
scale (ไม่บังคับ) มีผลต่อจํานวนพิกเซลที่แสดงผล scale=2 แสดงผลพิกเซลมากเป็น 2 เท่าของ scale=1 ในขณะที่ยังคงมีพื้นที่ครอบคลุมและระดับรายละเอียดเดิมอยู่ (กล่าวคือ เนื้อหาของแผนที่จะไม่เปลี่ยนแปลง) วิธีนี้มีประโยชน์สําหรับการพัฒนาการแสดงผลความละเอียดสูง ค่าเริ่มต้นคือ 1 ค่าที่ยอมรับคือ 1 และ 2 ดูข้อมูลเพิ่มเติมที่การปรับขนาดค่า
format (ไม่บังคับ) กําหนดรูปแบบของรูปภาพที่ได้ โดยค่าเริ่มต้น Maps Static API จะสร้างรูปภาพ PNG มีรูปแบบที่เป็นไปได้หลายอย่าง เช่น GIF, JPEG และ PNG รูปแบบที่ใช้จะขึ้นอยู่กับวิธีที่คุณต้องการนําเสนอรูปภาพ โดยทั่วไปไฟล์ JPEG จะบีบอัดได้มากกว่า ในขณะที่ GIF และ PNG ให้รายละเอียดมากกว่า ดูข้อมูลเพิ่มเติมได้ที่รูปแบบรูปภาพ
maptype (ไม่บังคับ) กําหนดประเภทแผนที่ที่จะสร้าง ค่าประเภทต่างๆ ที่เป็นไปได้ ได้แก่ roadmap, satellite, hybrid และ terrain ดูข้อมูลเพิ่มเติมได้ที่ประเภทแผนที่ของ API แบบคงที่ของ Maps
language (ไม่บังคับ) กําหนดภาษาที่จะใช้สําหรับแสดงป้ายกํากับในชิ้นส่วนแผนที่ โปรดทราบว่าพารามิเตอร์นี้ใช้ได้เฉพาะกับการ์ดประเทศบางรายการเท่านั้น หากชุดไทล์ไม่รองรับภาษาที่ต้องการ ระบบจะใช้ภาษาเริ่มต้นสําหรับชุดการ์ดนั้น
region (ไม่บังคับ) กําหนดเส้นขอบที่เหมาะสมที่จะแสดงโดยอิงตามความละเอียดอ่อนทางภูมิศาสตร์ทางการเมือง ยอมรับรหัสภูมิภาคที่ระบุเป็นค่า ccTLD ("โดเมนระดับบนสุด") 2 อักขระ ดูรายละเอียดความครอบคลุมของ Google Maps Platform สําหรับภูมิภาคที่รองรับ

พารามิเตอร์ฟีเจอร์

map_id (ไม่บังคับ) ระบุตัวระบุสําหรับแผนที่ที่เฉพาะเจาะจง รหัสแผนที่จะเชื่อมโยงแผนที่กับสไตล์หรือฟีเจอร์เฉพาะ และต้องเป็นของโปรเจ็กต์เดียวกับคีย์ API ที่ใช้เริ่มต้นแผนที่ ดูข้อมูลเพิ่มเติมได้ที่การใช้รหัสแผนที่
markers (ไม่บังคับ) กําหนดเครื่องหมายอย่างน้อย 1 รายการเพื่อแนบกับรูปภาพในตําแหน่งที่ระบุ พารามิเตอร์นี้ใช้คําจํากัดความของตัวทําเครื่องหมายเดี่ยวที่มีพารามิเตอร์คั่นด้วยอักขระไปป์ (|) คุณอาจวางตัวทําเครื่องหมายหลายรายการไว้ในพารามิเตอร์ markers เดียวกันตราบใดที่แสดงรูปแบบเดียวกัน คุณอาจเพิ่มตัวทําเครื่องหมายของสไตล์ที่ต่างกันเพิ่มเติมโดยการเพิ่มพารามิเตอร์ markers โปรดทราบว่าหากระบุเครื่องหมายสําหรับแผนที่ คุณไม่จําเป็นต้องระบุพารามิเตอร์ center และ zoom (ปกติจําเป็นต้องใช้) ดูข้อมูลเพิ่มเติมได้ที่เครื่องหมาย API แบบคงที่ของ Maps
path (ไม่บังคับ) กําหนดเส้นทาง 1 จุดของจุดที่เชื่อมต่ออย่างน้อย 2 จุดที่จะวางซ้อนบนรูปภาพในตําแหน่งที่ระบุ พารามิเตอร์นี้ใช้สตริงคําจํากัดความจุดคั่นด้วยอักขระไปป์ (|) หรือเส้นประกอบที่เข้ารหัสโดยใช้คํานําหน้า enc: ภายในการประกาศตําแหน่งของเส้นทาง คุณอาจเพิ่มเส้นทางได้โดยการเพิ่มพารามิเตอร์ path เพิ่มเติม โปรดทราบว่าหากระบุเส้นทางสําหรับแผนที่ คุณไม่จําเป็นต้องระบุพารามิเตอร์ center และ zoom (ปกติจําเป็นต้องใช้) ดูข้อมูลเพิ่มเติมได้ที่เส้นทาง API แบบคงที่ของ Maps
visible (ไม่บังคับ) ระบุตําแหน่งอย่างน้อย 1 ตําแหน่งที่ควรแสดงบนแผนที่ แม้ว่าจะไม่มีเครื่องหมายหรือสัญญาณบอกสถานะอื่นๆ แสดงก็ตาม ใช้พารามิเตอร์นี้เพื่อให้ฟีเจอร์หรือตําแหน่งบางรายการปรากฏใน Maps Static API
style (ไม่บังคับ) กําหนดรูปแบบที่กําหนดเองเพื่อเปลี่ยนแปลงการนําเสนอฟีเจอร์ที่เจาะจง (ถนน สวนสาธารณะ และฟีเจอร์อื่นๆ) ในแผนที่ พารามิเตอร์นี้ใช้อาร์กิวเมนต์ feature และ element ที่ระบุฟีเจอร์ในสไตล์ และชุดการดําเนินการรูปแบบเพื่อนําไปใช้กับฟีเจอร์ที่เลือก คุณใส่สไตล์ที่หลากหลายได้โดยเพิ่มพารามิเตอร์ style เพิ่มเติม ดูข้อมูลเพิ่มเติมได้ในแผนที่สไตล์

พารามิเตอร์ของคีย์และลายเซ็น

key (จําเป็น) ช่วยให้คุณตรวจสอบการใช้งาน API ของแอปพลิเคชันได้ใน Google Cloud Console และดูแลให้ Google สามารถติดต่อคุณเกี่ยวกับแอปพลิเคชันได้หากจําเป็น โปรดดูข้อมูลเพิ่มเติมที่หัวข้อใช้คีย์ API กับ Maps Static API
signature (แนะนํา) เป็นลายเซ็นดิจิทัลที่ใช้เพื่อยืนยันว่าคําขอสร้างเว็บไซต์ที่ใช้คีย์ API ของคุณได้รับอนุญาตให้ดําเนินการดังกล่าว คําขอที่ไม่มีลายเซ็นดิจิทัลอาจล้มเหลว โปรดดูข้อมูลเพิ่มเติมที่หัวข้อใช้ลายเซ็นดิจิทัล

การจํากัดขนาด URL

URL ของ Maps Static API จะจํากัดอยู่ที่ 8,192 อักขระ ในทางปฏิบัติ ก็อาจไม่จําเป็นต้องใช้ URL ที่ยาวกว่านี้ เว้นแต่คุณจะสร้างแผนที่ที่ซับซ้อนซึ่งมีตัวทําเครื่องหมายและเส้นทางจํานวนมาก

การใช้งานพารามิเตอร์

Maps Static API ค่อนข้างใช้งานง่ายเพราะประกอบด้วย URL พารามิเตอร์เท่านั้น ส่วนนี้จะอธิบายวิธีใช้พารามิเตอร์เหล่านี้เพื่อสร้าง URL

การระบุสถานที่ตั้ง

Maps Static API ต้องระบุตําแหน่งที่แน่นอนบนแผนที่ ทั้งเพื่อโฟกัสแผนที่ที่ตําแหน่งที่ถูกต้อง (โดยใช้พารามิเตอร์ center) และ/หรือวางหมุดที่ไม่บังคับ (โดยใช้พารามิเตอร์ markers) ที่ตําแหน่งบนแผนที่ Maps Static API จะใช้ตัวเลข (ค่าละติจูดและลองจิจูด) หรือสตริง (ที่อยู่) เพื่อระบุสถานที่ตั้งเหล่านี้ ค่าเหล่านี้จะระบุสถานที่ตั้งที่มีไวลด์การ์ด

พารามิเตอร์หลายรายการ (เช่น พารามิเตอร์ markers และ path) ใช้สถานที่ตั้งหลายแห่ง ในกรณีดังกล่าว สถานที่ตั้งจะคั่นด้วยอักขระไปป์ (|)

ละติจูดและลองจิจูด

ละติจูดและลองจิจูดจะกําหนดโดยใช้ตัวเลขภายในสตริงข้อความที่คั่นด้วยคอมมาที่มีความแม่นยําของทศนิยม 6 ตําแหน่ง เช่น "40.714728,-73.998672" เป็นค่าพิกัดโดเมนที่ถูกต้อง ระบบจะไม่สนใจความแม่นยํามากกว่าทศนิยม 6 ตําแหน่ง

ค่าลองจิจูดอิงตามระยะทางจากกรีนิช ประเทศอังกฤษ ซึ่งเป็นบ้านเกิดของเส้นเมริเดียนแรก เนื่องจาก Greenwich ตั้งอยู่ที่ 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 จะใช้จุดศูนย์กลางของเส้น/พื้นที่เป็นศูนย์ที่อยู่ หากมีข้อสงสัยว่าที่อยู่อาจระบุรหัสทางภูมิศาสตร์อย่างไร คุณทดสอบที่อยู่ได้โดยใช้ Geogeo Utility

หมายเหตุ: หากคุณเลือกที่จะระบุสถานที่โดยใช้วิธีการที่ต้องใช้การเข้ารหัสพิกัดภูมิศาสตร์ เช่น สตริงที่อยู่หรือเส้นที่มนุษย์อ่านได้ คําขอจะมีสถานที่ได้ไม่เกิน 15 แห่ง โดยขีดจํากัดนี้จะใช้กับสถานที่ตั้งที่ต้องใช้การเข้ารหัสทางภูมิศาสตร์เท่านั้น โดยจะไม่มีผลกับสถานที่ตั้งที่ระบุพร้อมพิกัดละติจูด/ลองจิจูด

ตัวอย่างต่อไปนี้จะสร้างรูปภาพแผนที่แบบคงที่สําหรับเบอร์เกลีย์ รัฐแคลิฟอร์เนีย

https://maps.googleapis.com/maps/api/staticmap?center=Berkeley,CA&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

เบิร์กลีย์ แคลิฟอร์เนีย

ระดับการซูม

Maps บน Google Maps มี "ระดับการซูม" จํานวนเต็มซึ่งกําหนดความละเอียดของมุมมองปัจจุบัน คุณสามารถใช้ระดับการซูมระหว่าง 0 (ระดับการซูมที่ต่ําที่สุด ซึ่งทั้งโลกสามารถดูบนแผนที่เดียว) และ 21+ (ลงไปถึงถนนและอาคารแต่ละหลัง) ได้ในมุมมอง roadmap เริ่มต้น โครงร่างอาคาร (หากมี) จะปรากฏในแผนที่เกี่ยวกับระดับการซูม 17 โดยค่านี้จะแตกต่างกันไปในแต่ละพื้นที่และอาจมีการเปลี่ยนแปลงเมื่อเวลาผ่านไปเมื่อข้อมูลเปลี่ยนแปลงไป

Google Maps กําหนดระดับการซูม 0 ให้ครอบคลุมโลกทั้งใบ ระดับการซูมที่ประสบความสําเร็จแต่ละระดับจะมีความแม่นยําเป็น 2 เท่าทั้งในมิติข้อมูลแนวนอนและแนวตั้ง ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีดําเนินการนี้ได้ในเอกสารประกอบของ JavaScript API ของ Google Maps

หมายเหตุ: ตําแหน่งที่ซูมได้บางแห่งอาจไม่ได้ปรากฏที่ตําแหน่งใดก็ได้ในโลก ระดับการซูมจะแตกต่างกันไปตามตําแหน่ง เนื่องจากข้อมูลในบางส่วนของโลกจะละเอียดกว่าตําแหน่งอื่นๆ

หากคุณส่งคําขอสําหรับระดับการซูมที่ไม่มีไทล์แผนที่อยู่ Maps Static API จะแสดงรูปภาพเปล่าแทน

รายการต่อไปนี้แสดงระดับรายละเอียดโดยประมาณที่คุณจะได้เห็นที่การซูมแต่ละระดับ

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

แผนที่ Small Equator

ค่าขนาด

พารามิเตอร์ size ของ Maps Static API จะกําหนดขนาดของแผนที่เป็นพิกเซลเพื่อให้แผนที่ที่มี size=200x200 แสดงเป็น 200 พิกเซล x 200 พิกเซล บนหน้าจอคอมพิวเตอร์ LCD ซึ่งปกติแล้วจะแสดงประมาณ 100 พิกเซลต่อนิ้ว (ppi) แผนที่ 200x200 จะอยู่ที่ประมาณ 2 นิ้วในแต่ละด้าน

อย่างไรก็ตาม อุปกรณ์เคลื่อนที่ก็รวมหน้าจอความละเอียดสูงที่มีความหนาแน่นของพิกเซลสูงกว่า 300 ppi มากขึ้นเรื่อยๆ ซึ่งมีลักษณะอย่างใดอย่างหนึ่งต่อไปนี้

ลดขนาดของรูปภาพ 200x200 พิกเซลเป็น 0.7 นิ้วเท่านั้น การแสดงผลป้ายกํากับและไอคอนมีขนาดเล็กเกินกว่าที่จะอ่านได้ หรือ
ปรับขนาด (ซูม) รูปภาพเพื่อให้อ่านได้ชัดเจน ซึ่งส่งผลให้ภาพแตกหรือแตกเป็นพิกเซล

ขนาดเล็กเกินไป	ฟูเกินไป

เวลาพัฒนาอุปกรณ์เคลื่อนที่ คุณอาจใช้พารามิเตอร์ scale ของ API เพื่อแสดงรูปภาพแผนที่ความละเอียดสูงขึ้นซึ่งแก้ปัญหาข้างต้นได้ ค่า scale จะคูณด้วย size เพื่อกําหนดขนาดเอาต์พุตจริงของรูปภาพเป็นพิกเซล โดยไม่เปลี่ยนพื้นที่ที่ครอบคลุมของแผนที่ ค่าเริ่มต้นของ scale คือ 1 ค่าที่ยอมรับคือ 1 และ 2

เช่น ค่าสเกล 2 จะแสดงผลพื้นที่ครอบคลุมแผนที่เดียวกันกับคําขอที่ไม่ได้ระบุสเกล แต่มีค่าพิกเซลมากกว่า 2 เท่าในแต่ละมิติข้อมูล ซึ่งรวมถึงถนนและป้ายกํากับเพื่อให้อ่านได้ง่าย หน้าจอขนาดเล็ก มีความละเอียดสูง รวมถึงเมื่อปรับขนาดเบราว์เซอร์

150x150	150x150&สเกล=2

รูปภาพดังกล่าวจะทํางานได้ดีในเบราว์เซอร์ในเดสก์ท็อปเมื่อแทรกลงในแท็ก img หรือ div ที่มีการตั้งค่าความสูงและความกว้างโดยใช้ CSS เบราว์เซอร์จะลดขนาดรูปภาพเป็นขนาดที่ถูกต้องโดยไม่สูญเสียคุณภาพของภาพ

ตารางนี้แสดงคําขอรูปภาพที่แตกต่างกัน 3 รายการ

อย่างแรกสําหรับรูปภาพขนาด 100x100 ไม่ได้ระบุค่าขนาด โดยใช้เดสก์ท็อปอย่างถูกต้อง แต่มีขนาดเล็กเกินไปที่จะอ่านในอุปกรณ์เคลื่อนที่
ตัวเลือกที่ 2 จะขยายขนาดแผนที่เป็น 2 เท่า ในเดสก์ท็อป CSS จะแทรกรูปภาพลงในองค์ประกอบ img ขนาด 100x100 ที่ระบุ แต่ในการลดขนาดรูปภาพ ถนนและป้ายกํากับจะมีขนาดเล็กเกินไป ในอุปกรณ์เคลื่อนที่ รูปภาพเป็นขนาดที่ถูกต้อง แต่ถนนและป้ายกํากับทั้งหมดอ่านไม่ออก
คําขอที่ 3 มีไว้สําหรับแผนที่ขนาด 100x100 ที่มี scale=2 รูปภาพจะแสดงผลโดยมีรายละเอียดขนาด 200 พิกเซล เดสก์ท็อปจะปรับสัดส่วนให้ลงตัวพอดีมากจนไม่สามารถแยกความแตกต่างจากคําขอขนาด 100x100 เดิมได้ แต่เบราว์เซอร์ในอุปกรณ์เคลื่อนที่ก็จะได้ประโยชน์จากความละเอียดเพิ่มเติมที่ได้รับจาก API

คําขอรูปภาพ
อุปกรณ์	`100x100`	`200x200`	`100x100&scale=2`
เดสก์ท็อป (ที่มี `height="100px"` และ `width="100px"` ในแท็ก `img`)
ความละเอียดสูง (จําลอง)

เคล็ดลับ: แพลตฟอร์มอุปกรณ์เคลื่อนที่ เช่น Android และ iOS จะทําให้แอปรองรับหน้าจอความละเอียดสูงได้ โดยระบุรูปภาพแยกกันสําหรับแต่ละความละเอียด พารามิเตอร์การปรับขนาดช่วยให้ขอรูปภาพแผนที่สําหรับหน้าจอความละเอียดมาตรฐานได้โดยง่าย และจับคู่แผนที่สําหรับหน้าจอความละเอียดสูงได้ง่ายๆ เพียงตั้งค่า scale=1 และ scale=2 ตามลําดับ

สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการพัฒนาการแสดงผลสําหรับอุปกรณ์เคลื่อนที่และความละเอียดสูง เราขอแนะนําให้อ่านข้อมูลต่อไปนี้

รองรับหลายหน้าจอในเอกสารประกอบสําหรับนักพัฒนาซอฟต์แวร์ Android
คําแนะนําของ Webkit.org สําหรับการพัฒนาเว็บไซต์ DPI สูง
การสนับสนุนหน้าจอความละเอียดสูงในไลบรารีนักพัฒนาซอฟต์แวร์ iOS

รูปแบบรูปภาพ

รูปภาพอาจแสดงในรูปแบบกราฟิกเว็บทั่วไปหลายรูปแบบ ได้แก่ GIF, JPEG และ PNG พารามิเตอร์ format ใช้ค่าใดค่าหนึ่งต่อไปนี้

png8 หรือ png (ค่าเริ่มต้น) จะระบุรูปแบบ PNG 8 บิต
png32 ระบุรูปแบบ PNG 32 บิต
gif ระบุรูปแบบ GIF
jpg ระบุรูปแบบการบีบอัด JPEG
jpg-baseline ระบุรูปแบบการบีบอัดแบบ Progressive 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 Maps แบบมาตรฐานโดยใช้สไตล์ของคุณเอง ดูคู่มือเกี่ยวกับแผนที่สไตล์

ตัวทำเครื่องหมาย

พารามิเตอร์ markers กําหนดชุดของเครื่องหมาย (หมุดแผนที่) อย่างน้อย 1 ชุดที่ตําแหน่ง เครื่องหมายแต่ละรายการที่กําหนดภายในการประกาศ markers รายการเดียวต้องแสดงรูปแบบภาพเดียวกัน หากคุณต้องการแสดงเครื่องหมายที่มีสไตล์ต่างกัน คุณจะต้องป้อนพารามิเตอร์ markers หลายรายการที่มีข้อมูลรูปแบบแยกต่างหาก

พารามิเตอร์ markers จะใช้ชุดการกําหนดค่า (ข้อบ่งชี้) ในรูปแบบต่อไปนี้

markers=markerStyles|markerLocation1| markerLocation2|... เป็นต้น

ระบบจะประกาศชุด MarkStyles ในช่วงต้นของการประกาศ 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}
โปรดทราบว่าเครื่องหมายจะไม่รองรับความแตกต่าง (ระบุโดยใช้ค่าสีแบบเลขฐาน 16 แบบ 32 บิต) ในเครื่องหมาย แม้ว่ารองรับเส้นทางดังกล่าว
label: (ไม่บังคับ) ระบุอักขระตัวพิมพ์ใหญ่ตัวเดียวจากชุด {A-Z, 0-9} (ข้อกําหนดสําหรับอักขระตัวพิมพ์ใหญ่เป็นของ API เวอร์ชันนี้ใหม่) โปรดทราบว่าตัวทําเครื่องหมายเริ่มต้นและตัวทําเครื่องหมายขนาด mid เป็นตัวทําเครื่องหมายเดียวที่แสดงพารามิเตอร์ alphanumeric-character ได้ เครื่องหมาย tiny และ small แสดงอักขระที่เป็นตัวอักษรและตัวเลขคละกันไม่ได้

การปรับขนาดมาร์คเกอร์

ค่า scale จะคูณด้วยขนาดรูปภาพตัวทําเครื่องหมายเพื่อผลิตขนาดเอาต์พุตจริงของตัวทําเครื่องหมายเป็นพิกเซล ค่าสเกลเริ่มต้นคือ 1 ค่าที่ยอมรับคือ 1, 2 และ 4

ขนาดสูงสุดของพิกเซลในรูปภาพจะมีผลหลังจากใช้การปรับขนาด เช่น หากตั้งค่าเครื่องหมายเป็น scale:2 เครื่องหมายจะมีขนาดใหญ่กว่าขนาดสูงสุด 4,096 พิกเซล ตราบใดที่ความละเอียดลดลงเหลือน้อยกว่า 4,096 พิกเซลหลังจากปรับขนาด ใช้การปรับขนาดเครื่องหมายร่วมกับการปรับขนาดแผนที่เมื่อแสดงแผนที่ความละเอียดสูง

ตําแหน่งของเครื่องหมาย

ตัวบ่งชี้เครื่องหมายแต่ละตัวต้องมีชุดตําแหน่งตั้งแต่ 1 ตําแหน่งขึ้นไปเพื่อวางเครื่องหมายบนแผนที่ สถานที่ตั้งเหล่านี้อาจระบุเป็นค่าละติจูด/ลองจิจูดหรือเป็นที่อยู่ ระบบจะแยกสถานที่เหล่านี้โดยใช้อักขระไปป์ (|)

หมายเหตุ: หากคุณเลือกที่จะระบุตําแหน่งของเครื่องหมายโดยใช้วิธีการที่จําเป็นต้องใช้การเข้ารหัสทางภูมิศาสตร์ เช่น สตริงที่อยู่หรือเส้นที่มนุษย์อ่านได้ คําขอจะมีเครื่องหมายได้ไม่เกิน 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

รหัสไปรษณีย์ของบรุกลิน 3 รหัส

หากต้องการกําหนดเครื่องหมายด้วยสไตล์ที่ต่างกัน เราต้องใส่พารามิเตอร์ markers หลายรายการ พารามิเตอร์ markers ชุดนี้จะกําหนดเครื่องหมาย 3 รายการ ได้แก่ เครื่องหมายสีน้ําเงิน 1 รายการที่มีป้ายกํากับว่า "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 ตําแหน่งบนแผนที่เท่านั้น คุณสามารถใช้แต่ละไอคอนที่ไม่ซ้ํากัน กับสถานที่มากกว่า 1 แห่งบน markers ในแผนที่ของคุณ

รูปแบบไอคอน:

รูปภาพไอคอนอาจอยู่ในรูปแบบ PNG, JPEG หรือ GIF แต่เราขอแนะนําให้ใช้ PNG
ไอคอนอาจมีขนาดสูงสุดได้ถึง 4096 พิกเซล (64x64 สําหรับภาพสี่เหลี่ยมจัตุรัส)

ตัวอย่างไอคอนที่กําหนดเอง

ตัวอย่างที่ 1 สร้างไอคอนที่กําหนดเองและวางไอคอนโดยใช้ Anchor

http://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

เมืองต่างๆ ใน 3 เมืองของออสเตรเลีย มีไอคอนที่กําหนดเองหลากหลายรูปพร้อมแท็ก Anchor

ตัวอย่างที่ 2 สร้างไอคอนที่กําหนดเองแบบเดียวกับตัวอย่างที่ 1 แต่ไม่ได้กําหนดตําแหน่งไอคอนโดยใช้แท็ก Anchor โดยอาศัยแท็ก Anchor เริ่มต้นจากตรงกลางด้านล่าง

http://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

เส้นทาง API แบบคงที่ของ Maps

พารามิเตอร์ path กําหนดชุดสถานที่ตั้งอย่างน้อย 1 แห่งที่เชื่อมต่อกับเส้นทางที่จะวางซ้อนบนรูปภาพแผนที่ พารามิเตอร์ path จะใช้ชุดการกําหนดค่า (ตัวบ่งชี้เส้นทาง) ของรูปแบบต่อไปนี้

path=pathStyles|pathLocation1|pathLocation2|... เป็นต้น

โปรดทราบว่าจุดเส้นทางทั้ง 2 จุดแยกกันด้วยอักขระไปป์ (|) เนื่องจากทั้งข้อมูลรูปแบบและข้อมูลจุดถูกคั่นด้วยอักขระไปป์ ข้อมูลรูปแบบต้องปรากฏก่อนในข้อบ่งชี้เส้นทาง เมื่อเซิร์ฟเวอร์ Maps Static API พบตําแหน่งในตัวบ่งชี้เส้นทาง ระบบจะถือว่าพารามิเตอร์เส้นทางอื่นๆ ทั้งหมดเป็นตําแหน่งเช่นกัน

รูปแบบเส้นทาง

ชุดของตัวบ่งชี้รูปแบบเส้นทางคือชุดการกําหนดค่าที่คั่นด้วยอักขระไปป์ (|) ข้อบ่งชี้สไตล์นี้จะกําหนดแอตทริบิวต์ภาพที่จะใช้เมื่อแสดงเส้นทาง ตัวบ่งชี้สไตล์เหล่านี้มีการกําหนดมูลค่าคีย์/ค่าต่อไปนี้

weight: (ไม่บังคับ) ระบุความหนาของเส้นทางเป็นพิกเซล หากไม่ได้ตั้งค่าพารามิเตอร์ weight เส้นทางจะปรากฏในความหนาเริ่มต้น (5 พิกเซล)
color: (ไม่บังคับ) ระบุสีเป็นค่า 24 บิต (เช่น color=0xFFFFCC) หรือค่าฐานสิบหก 32 บิต (เช่น color=0xFFFFCCFF) หรือจากชุด {black, brown, green, purple, yellow, blue, gray, orange, red, white}

เมื่อระบุค่าฐานสิบหก 32 บิตแล้ว อักขระ 2 ตัวสุดท้ายจะระบุค่าความโปร่งใสแบบ 8 บิต ค่านี้จะแตกต่างกันไประหว่าง 00 (โปร่งใสทั้งหมด) และ FF (ทึบแสงทั้งหมด) โปรดทราบว่าเส้นทางรองรับการพิมพ์ข้ามเส้นทาง แม้ว่าระบบจะไม่รองรับเครื่องหมายก็ตาม
fillcolor: (ไม่บังคับ) ระบุทั้งว่าเส้นทางจะทําเครื่องหมายพื้นที่รูปหลายเหลี่ยมและระบุสีเติมที่จะใช้เป็นการวางซ้อนภายในพื้นที่นั้น ชุดตําแหน่งต่อไปนี้ไม่จําเป็นต้องเป็นวนซ้ํา "ปิด" เซิร์ฟเวอร์ Maps Static API จะรวมจุดแรกและสุดท้ายโดยอัตโนมัติ อย่างไรก็ตาม เราจะไม่ปิดเส้นที่ด้านนอกของบริเวณที่กรอกไว้ เว้นแต่คุณจะระบุจุดเริ่มต้นและจุดสิ้นสุดแบบเดียวกันโดยเฉพาะ
geodesic: (ไม่บังคับ) บ่งบอกว่าเส้นทางที่ขอควรตีความเป็นเส้นภูมิศาสตร์ที่คดเคี้ยวของโลก เมื่อเป็นเท็จ เส้นทางจะแสดงผลเป็นเส้นตรงในพื้นที่หน้าจอ ค่าเริ่มต้นจะเป็น "เท็จ"

ตัวอย่างคําจํากัดความของเส้นทาง

เส้นบางสีน้ําเงิน ความทึบแสง 50%: path=color:0x0000ff80|weight:1
เส้นทึบสีแดง: path=color:0xff0000ff|weight:5
เส้นสีขาวทึบหนา: path=color:0xffffffff|weight:10

รูปแบบเส้นทางเหล่านี้เป็นตัวเลือกที่ไม่บังคับ หากต้องการแอตทริบิวต์เริ่มต้น คุณอาจข้ามการกําหนดแอตทริบิวต์เส้นทาง ในกรณีดังกล่าว "อาร์กิวเมนต์" แรกของเส้นทางจะแทนจุดแรก (ตําแหน่ง) ที่ประกาศ

จุดบนเส้นทาง

ในการวาดเส้นทาง พารามิเตอร์ path ต้องเกิน 2 จุดขึ้นไป จากนั้น Maps Static API จะเชื่อมต่อเส้นทางไปตามจุดเหล่านั้นตามลําดับที่ระบุ pathPoint แต่ละรายการจะแสดงด้วย pathDescriptor คั่นด้วยอักขระ | (pipe)

ตัวอย่างต่อไปนี้ระบุเส้นทางสีน้ําเงินที่มีค่าความทึบแสง 50% โดยค่าเริ่มต้นจากยูเนียนสี่เหลี่ยมจัตุรัสในนิวยอร์กเป็นไทม์สแควร์

เส้นทางจาก Union Sq ไปยัง Times Sq

ข้อกําหนดเฉพาะของพารามิเตอร์ path รายการ ได้แก่

path=color:0x0000ff|weight:5|40.737102,-73.990318|40.749825,-73.987963|40.752946,-73.987384|40.755823,-73.986397

ตัวอย่างต่อไปนี้กําหนดเส้นทางเดียวกัน โดยกําหนดเส้นทึบสีแดงที่มีความทึบแสง 100% แทน

เส้นทางจาก Union Sq ไปยัง Times Sq

พารามิเตอร์ของ path แบบเจาะจงมีดังนี้

path=color:0xff0000ff|weight:5|40.737102,-73.990318|40.749825,-73.987963|40.752946,-73.987384|40.755823,-73.986397

ตัวอย่างที่ 5 ระบุพื้นที่รูปหลายเหลี่ยมภายในแมนฮัตตันและส่งต่อชุดของสี่แยกเป็นตําแหน่ง

เส้นทางจาก Union Sq ไปยัง Times Sq

พารามิเตอร์ของ 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

ตัวอย่างต่อไปนี้จะสรุปหลักสูตรของทางหลวงอะแลสกาจาก Dawson Creek, BC ถึง Delta Junction หรือที่เรียกว่าพอลไลน์ที่เข้ารหัส

https://maps.googleapis.com/maps/api/staticmap
?size=400x400&center=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&center=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

แผนที่ Cambridge

การวางตําแหน่งแผนที่โดยปริยาย

โดยปกติคุณจะต้องระบุพารามิเตอร์ของ URL center และ zoom เพื่อกําหนดตําแหน่งและระดับการซูมของแผนที่ที่คุณสร้าง อย่างไรก็ตาม หากคุณระบุพารามิเตอร์ markers, path หรือ visible คุณก็ให้ Maps Static API กําหนดศูนย์กลางที่ถูกต้องและระดับการซูมโดยนัยตามการประเมินตําแหน่งขององค์ประกอบเหล่านี้แทนได้

หากจัดเตรียมองค์ประกอบ 2 รายการขึ้นไป API แบบคงที่ของ Maps จะกําหนดศูนย์กลางและระดับการซูมที่เหมาะสม โดยให้ระยะขอบกว้างสําหรับองค์ประกอบที่มี ตัวอย่างนี้แสดงแผนที่ของซานฟรานซิสโก โอกแลนด์ และซานโฮเซ รัฐแคลิฟอร์เนีย

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 Embedded API, Maps SDK สําหรับ Android หรือ Maps SDK สําหรับ iOS) แล้วทําไม API เหล่านี้จึงไม่ตรงตามความต้องการของคุณ
ภาพหน้าจอ การจําลอง หรือตัวอย่างวิธีใช้รูปภาพขนาดใหญ่
การใช้งานรายเดือนโดยประมาณสําหรับรูปภาพขนาดใหญ่

เราจะตรวจสอบคําขอของคุณโดยอิงจากข้อมูลที่ระบุไว้และพิจารณาว่ากรณีการใช้งานของคุณเป็นไปตามข้อกําหนดในการให้บริการของ Google Maps Platform หรือไม่

ขนาดสูงสุดที่เราให้ได้คือ 2048 x 2048 พิกเซล

การแก้ไขปัญหาและการสนับสนุน

ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้ Maps Static API ได้ที่หน้าการสนับสนุน

Maps Static API อาจแสดงข้อผิดพลาดหรือคําเตือนเมื่อเกิดข้อผิดพลาด คุณควรตรวจสอบคําเตือนโดยเฉพาะหากสังเกตเห็นว่ามีบางอย่างขาดหายไปจากแผนที่ ขอแนะนําให้ตรวจหาคําเตือนก่อนที่จะเปิดแอปพลิเคชันใหม่ โปรดทราบว่าคําเตือนอาจไม่ชัดเจนในทันทีเนื่องจากปรากฏในส่วนหัว HTTP อ่านข้อมูลเพิ่มเติมได้ในคู่มือข้อผิดพลาดและคําเตือน