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

เกริ่นนำ

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 ของ 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 พิกเซล แผนที่ที่มีขนาดเล็กกว่า 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 แบบคงที่ของ Maps
• language (ไม่บังคับ) กำหนดภาษาที่จะใช้แสดงป้ายกำกับบนชิ้นส่วนแผนที่ โปรดทราบว่าชุดการ์ดจะรองรับพารามิเตอร์นี้ในบางประเทศเท่านั้น หากชุดการ์ดไม่รองรับภาษาตามคำขอ ระบบจะใช้ภาษาเริ่มต้นสำหรับชุดการ์ดดังกล่าว
• region (ไม่บังคับ) กำหนดเขตแดนที่เหมาะสมที่จะแสดง โดยอิงตามความละเอียดอ่อนทางการเมืองและการเมือง ยอมรับรหัสภูมิภาคที่ระบุเป็นค่า ccTLD แบบ 2 อักขระ ("โดเมนระดับบนสุด") ดูรายละเอียดการครอบคลุมของ Google Maps Platform สำหรับภูมิภาคที่รองรับ

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

• map_id (ไม่บังคับ) ระบุตัวระบุสำหรับแผนที่ที่เฉพาะเจาะจง รหัสแผนที่จะเชื่อมโยงแผนที่กับรูปแบบหรือฟีเจอร์หนึ่งๆ และต้องอยู่ในโปรเจ็กต์เดียวกันกับคีย์ API ที่ใช้ในการเริ่มต้นแมป ดูข้อมูลเพิ่มเติมได้ที่การใช้รหัสแผนที่
• markers (ไม่บังคับ) กำหนดตัวทำเครื่องหมายอย่างน้อย 1 รายการเพื่อแนบกับรูปภาพ ณ ตำแหน่งที่ระบุ พารามิเตอร์นี้ใช้คำจำกัดความของตัวทำเครื่องหมายเดียวที่มีพารามิเตอร์ซึ่งคั่นด้วยอักขระไปป์ (|) คุณสามารถวางตัวทำเครื่องหมายหลายรายการไว้ในพารามิเตอร์ markers เดียวกันตราบใดที่แสดงรูปแบบเดียวกัน คุณจะเพิ่มเครื่องหมายเพิ่มเติมของรูปแบบที่ต่างกันได้โดยเพิ่มพารามิเตอร์ markers เพิ่มเติม โปรดทราบว่าหากคุณใส่เครื่องหมายสำหรับแผนที่ คุณไม่จำเป็นต้องระบุพารามิเตอร์ center และ zoom (โดยปกติ) ดูข้อมูลเพิ่มเติมได้ที่เครื่องหมาย API แบบคงที่ของ Maps
• path (ไม่บังคับ) กำหนดเส้นทางเดียวของจุดเชื่อมต่อตั้งแต่ 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 จำกัดจำนวนอักขระที่ 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

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

หากคุณส่งคำขอระดับการซูมที่ไม่มีชิ้นส่วนแผนที่อยู่ 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

สเกลค่า

พารามิเตอร์ size ของ Maps Static API จะกำหนดขนาดแผนที่เป็นพิกเซล เพื่อให้แผนที่ที่มี size=200x200 แสดงผลเป็น 200x200 พิกเซล ในจอคอมพิวเตอร์ 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 เบราว์เซอร์จะลดขนาดรูปภาพเป็นขนาดที่ถูกต้องโดยไม่สูญเสียคุณภาพ

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

• รายการแรกมีไว้สำหรับรูปภาพขนาด 100x100 โดยไม่ระบุค่าการปรับขนาด ซึ่งแสดงผลอย่างเหมาะสมในเดสก์ท็อป แต่เล็กเกินกว่าจะอ่านในอุปกรณ์เคลื่อนที่ได้
• ไอคอนที่สองจะเพิ่มขนาดแผนที่เป็น 2 เท่า ในเดสก์ท็อป CSS จะพอดีกับองค์ประกอบ img ขนาด 100x100 ที่ระบุ แต่เมื่อลดขนาดรูปภาพ ถนนและป้ายกำกับจะมีขนาดเล็กเกินไป รูปภาพมีขนาดที่ถูกต้องในอุปกรณ์เคลื่อนที่ แต่ก็อ่านไม่ออกเหมือนกันว่าถนนและป้ายกำกับ
• คำขอที่สามเป็นคำขอสำหรับแผนที่ขนาด 100x100 ที่มี scale=2 รูปภาพจะแสดงโดยมีรายละเอียด 200px โดยเดสก์ท็อปจะลดขนาดลงอย่างสมบูรณ์แบบจนไม่สามารถแยกความแตกต่างจากคำขอเดิมขนาด 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 ระบุรูปแบบ GIF
• jpg ระบุรูปแบบการบีบอัด JPEG
• jpg-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 Maps มาตรฐานโดยใช้รูปแบบของคุณเอง ดูคำแนะนำเกี่ยวกับแผนที่ที่มีสไตล์

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

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

  โปรดทราบว่าตัวทำเครื่องหมายไม่รองรับความโปร่งแสง (ระบุโดยใช้ค่าสีแบบเลขฐาน 16 แบบ 32 บิต) แม้ว่าจะรองรับเส้นทางก็ตาม

• label: (ไม่บังคับ) ระบุอักขระuppercaseที่เป็นตัวอักษรและตัวเลขคละกัน 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 ตัว ได้แก่ เครื่องหมายสีน้ำเงิน 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 ตำแหน่งเท่านั้น ไอคอนที่ไม่ซ้ำกันแต่ละไอคอนอาจใช้กับตำแหน่ง 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 แต่ไม่ได้กำหนดตำแหน่งไอคอนโดยใช้จุดยึด โดยใช้จุดยึดเริ่มต้นของตรงกลางด้านล่าง

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

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

ตัวอย่างต่อไปนี้แสดงเส้นทางของทางหลวงอะแลสกาจากดอว์สันครีก ก่อนคริสตกาลไปเดลต้าจังก์ชัน รัฐอะแลสกาด้วยเส้นประกอบที่เข้ารหัส

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

วิวพอร์ต

รูปภาพอาจระบุ Viewport โดยการระบุตำแหน่งที่มองเห็นได้โดยใช้พารามิเตอร์ 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) โปรด ติดต่อทีมสนับสนุนและระบุข้อมูลต่อไปนี้

1. กรณีการใช้งานและเหตุผลที่คุณต้องการรูปภาพขนาดใหญ่
2. คุณพิจารณาใช้ Google Maps Platform API อื่นๆ (Maps JavaScript API, Maps Embed API, Maps SDK สำหรับ Android หรือ Maps SDK สำหรับ iOS) และเหตุใดจึงไม่ตรงตามความต้องการของคุณ
3. ภาพหน้าจอ การจำลอง หรือตัวอย่างวิธีที่คุณจะใช้รูปภาพขนาดใหญ่
4. การใช้งานรายเดือนโดยประมาณสำหรับรูปภาพขนาดใหญ่

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

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

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

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

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