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

ข้อมูลเบื้องต้น

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 แบบคงที่ของ 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

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

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

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

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

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

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

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

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

หากต้องการกำหนดตัวทำเครื่องหมายที่มีรูปแบบแตกต่างกัน เราต้องใส่พารามิเตอร์ 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

เมืองในออสเตรเลีย 3 แห่ง มีไอคอนที่กำหนดเองต่างกันในตำแหน่งต่างๆ ด้วยหมุด

ตัวอย่างที่ 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

เมืองในออสเตรเลีย 3 แห่ง ไอคอนที่กำหนดเองต่างกัน พร้อมตำแหน่งเริ่มต้น

เส้นทาง 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% จาก ยูเนียนสแควร์ นิวยอร์กไปยังไทม์สแควร์ รัฐนิวยอร์ก

เส้นทางจาก 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

ตัวอย่างถัดไปกำหนดพื้นที่รูปหลายเหลี่ยมภายในแมนฮัตตัน แล้วส่งทางแยกเป็นหลายทางในสถานที่

เส้นทางจาก 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

ตัวอย่างต่อไปนี้สรุปเส้นทางของทางหลวงอะแลสกาจากดอว์สันครีก (BC) จนถึงย่านเดลต้า (AK) ที่มีเส้นประกอบที่เข้ารหัส

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

แผนที่เคมบริดจ์

การกำหนดตำแหน่งบนแผนที่โดยนัย

ปกติคุณต้องระบุพารามิเตอร์ 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. การใช้งานรายเดือนโดยประมาณสำหรับรูปภาพขนาดใหญ่

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

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

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

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

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