ฝังแผนที่

คู่มือนี้แสดงวิธีฝังแผนที่แบบอินเทอร์แอกทีฟลงในหน้าเว็บ

สร้าง URL ของ Maps Embed API

ตัวอย่าง URL ที่โหลด Maps Embed API มีดังนี้

https://www.google.com/maps/embed/v1/MAP_MODE?key=YOUR_API_KEY&PARAMETERS

แทนที่:

• MAP_MODEด้วยโหมดแผนที่
• YOUR_API_KEY ด้วยคีย์ API ของคุณ ดูข้อมูลเพิ่มเติมได้ที่รับคีย์ API
• PARAMETERS พร้อมพารามิเตอร์ที่จำเป็นและไม่บังคับสำหรับโหมดแผนที่

เพิ่ม URL ลงใน iframe

หากต้องการใช้ Maps Embed API ในหน้าเว็บ ให้ตั้งค่า URL ที่คุณสร้างเป็นค่าของแอตทริบิวต์ src ของ iframe ควบคุมขนาดของแผนที่ด้วยแอตทริบิวต์ height และ width ของ iframe เช่น

<iframe
  width="450"
  height="250"
  frameborder="0" style="border:0"
  referrerpolicy="strict-origin-when-cross-origin"
  src="https://www.google.com/maps/embed/v1/MAP_MODE?key=YOUR_API_KEY&PARAMETERS"
  allowfullscreen>
</iframe>

ตัวอย่าง iframe ด้านบนใช้พร็อพเพอร์ตี้เพิ่มเติมต่อไปนี้

• พร็อพเพอร์ตี้ allowfullscreen เพื่ออนุญาตให้บางส่วนของแผนที่แสดงแบบเต็มหน้าจอ
• พร็อพเพอร์ตี้ frameborder="0" และ style="border:0" เพื่อนำเส้นขอบ iframe มาตรฐานออกจากรอบๆ แผนที่
• พร็อพเพอร์ตี้ referrerpolicy="strict-origin-when-cross-origin" ช่วยให้เบราว์เซอร์ส่งโดเมนของเว็บไซต์เป็นส่วนหัว Referer ไปยัง Google ซึ่งจะช่วยให้ข้อจำกัดของคีย์ API ตรวจสอบคำขอได้ ขณะเดียวกันก็รักษาเส้นทางหน้าเว็บที่เฉพาะเจาะจงของคุณให้เป็นส่วนตัว

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

ข้อมูล URL ที่มาและข้อจำกัดของคีย์ API

หากเว็บไซต์ที่โฮสต์มีการตั้งค่าเมตาแท็ก referrer เป็น no-referrer หรือ same-origin เบราว์เซอร์จะไม่ส่งส่วนหัว Referer ไปยัง Google ซึ่งอาจทำให้ข้อจำกัดของคีย์ API ปฏิเสธคำขอ เพื่อให้ข้อจำกัดทำงานได้อย่างถูกต้อง ให้เพิ่มพร็อพเพอร์ตี้ referrerpolicy ลงใน iframe ดังตัวอย่างด้านบน เพื่ออนุญาตให้ส่งส่วนหัว Referer ไปยัง Google อย่างชัดแจ้ง

• strict-origin-when-cross-origin (แนะนำ): ส่งเฉพาะโดเมนฐาน (เช่น https://example.com/) ไปยัง Google วิธีนี้จะช่วยรักษาเส้นทางหน้าเว็บที่เฉพาะเจาะจงให้เป็นส่วนตัว ขณะเดียวกันก็ยังอนุญาตให้การจำกัดคีย์ API ทำงานได้
• no-referrer-when-downgrade (เดิม): ส่ง URL ทั้งหมด รวมถึงเส้นทางหน้าเว็บและพารามิเตอร์การค้นหาที่เฉพาะเจาะจง (เช่น https://example.com/contact?user=123)

ดูข้อมูลเพิ่มเติมเกี่ยวกับส่วนหัว Referrer-Policy

เลือกโหมดแผนที่

คุณระบุโหมดแผนที่อย่างใดอย่างหนึ่งต่อไปนี้เพื่อใช้ใน URL คำขอได้

• place: แสดงหมุดแผนที่ที่สถานที่หรือที่อยู่หนึ่งๆ เช่น จุดสังเกต ธุรกิจ ลักษณะทางภูมิศาสตร์ หรือเมือง
• view: แสดงแผนที่ที่ไม่มีเครื่องหมายหรือเส้นทาง
• directions: แสดงเส้นทางระหว่างจุดที่ระบุตั้งแต่ 2 จุดขึ้นไปบนแผนที่ รวมถึงระยะทางและระยะเวลาเดินทาง
• streetview: แสดงภาพพาโนรามาแบบอินเทอร์แอกทีฟจากสถานที่ที่กำหนด
• search: แสดงผลการค้นหาทั่วทั้งภูมิภาคแผนที่ที่มองเห็นได้

โหมด place

URL ต่อไปนี้ใช้โหมดแผนที่ place เพื่อแสดงเครื่องหมายแผนที่ที่หอไอเฟล

https://www.google.com/maps/embed/v1/place
  ?key=YOUR_API_KEY
  &q=Eiffel+Tower,Paris+France

คุณใช้พารามิเตอร์ต่อไปนี้ได้

พารามิเตอร์	ประเภท	คำอธิบาย	ค่าที่ยอมรับ
q	จำเป็น	กำหนดตำแหน่งเครื่องหมายบนแผนที่	ชื่อสถานที่, ที่อยู่, Plus Code หรือรหัสสถานที่ที่ใช้ URL-escape Maps Embed API รองรับทั้ง + และ %20 เมื่อเว้นวรรค เช่น แปลง "City Hall, New York, NY" เป็น City+Hall,New+York,NY หรือ Plus Code "849VCWC8+R9" เป็น 849VCWC8%2BR9
center	ไม่บังคับ	กำหนดจุดศูนย์กลางของมุมมองแผนที่	ยอมรับค่าละติจูดและลองจิจูดที่คั่นด้วยคอมมา เช่น 37.4218,-122.0840
zoom	ไม่บังคับ	กำหนดระดับการซูมเริ่มต้นของแผนที่	ค่าต่างๆ มีตั้งแต่ 0 (ทั้งโลก) ไปจนถึง 21 (อาคารแต่ละหลัง) ขีดจำกัดสูงสุดอาจแตกต่างกันไปตามข้อมูลแผนที่ที่มีอยู่ในตำแหน่งที่เลือก
maptype	ไม่บังคับ	กำหนดประเภทของชิ้นส่วนแผนที่ที่จะโหลด	roadmap (ค่าเริ่มต้น) หรือ satellite
language	ไม่บังคับ	กำหนดภาษาที่จะใช้สำหรับองค์ประกอบ UI และสำหรับการแสดงป้ายกำกับบนชิ้นส่วนแผนที่ โดยค่าเริ่มต้น ผู้เข้าชมจะเห็นแผนที่ในภาษาของตนเอง ระบบรองรับพารามิเตอร์นี้สำหรับไทล์ของบางประเทศเท่านั้น หากไม่รองรับภาษาที่ขอสำหรับชุดไทล์ ระบบจะใช้ภาษาเริ่มต้นสำหรับชุดไทล์นั้น
region	ไม่บังคับ	กำหนดเส้นขอบและป้ายกำกับที่เหมาะสมที่จะแสดงตามความละเอียดอ่อนทางภูมิรัฐศาสตร์	ยอมรับรหัสภูมิภาคที่ระบุเป็นค่า 2 อักขระ (ไม่ใช่ตัวเลข) ของแท็กย่อยภูมิภาค Unicode ที่แมปกับค่า 2 อักขระของ ccTLD ("โดเมนระดับบนสุด") ที่คุ้นเคย ดูภูมิภาคที่รองรับได้ที่รายละเอียดความครอบคลุมของ Google Maps Platform

โหมด view

ตัวอย่างต่อไปนี้ใช้โหมด view และพารามิเตอร์ maptype ที่ไม่บังคับเพื่อแสดงมุมมองดาวเทียมของแผนที่

https://www.google.com/maps/embed/v1/view
  ?key=YOUR_API_KEY
  &center=-33.8569,151.2152
  &zoom=18
  &maptype=satellite

คุณใช้พารามิเตอร์ต่อไปนี้ได้

พารามิเตอร์	ประเภท	คำอธิบาย	ค่าที่ยอมรับ
center	จำเป็น	กำหนดจุดศูนย์กลางของมุมมองแผนที่	ยอมรับค่าละติจูดและลองจิจูดที่คั่นด้วยคอมมา เช่น 37.4218,-122.0840
zoom	ไม่บังคับ	กำหนดระดับการซูมเริ่มต้นของแผนที่	ค่าต่างๆ มีตั้งแต่ 0 (ทั้งโลก) ไปจนถึง 21 (อาคารแต่ละหลัง) ขีดจำกัดสูงสุดอาจแตกต่างกันไปตามข้อมูลแผนที่ที่มีอยู่ในตำแหน่งที่เลือก
maptype	ไม่บังคับ	กำหนดประเภทของชิ้นส่วนแผนที่ที่จะโหลด	roadmap (ค่าเริ่มต้น) หรือ satellite
language	ไม่บังคับ	กำหนดภาษาที่จะใช้สำหรับองค์ประกอบ UI และสำหรับการแสดงป้ายกำกับบนชิ้นส่วนแผนที่ โดยค่าเริ่มต้น ผู้เข้าชมจะเห็นแผนที่ในภาษาของตนเอง ระบบรองรับพารามิเตอร์นี้สำหรับไทล์ของบางประเทศเท่านั้น หากไม่รองรับภาษาที่ขอสำหรับชุดไทล์ ระบบจะใช้ภาษาเริ่มต้นสำหรับชุดไทล์นั้น
region	ไม่บังคับ	กำหนดเส้นขอบและป้ายกำกับที่เหมาะสมที่จะแสดงตามความละเอียดอ่อนทางภูมิรัฐศาสตร์	ยอมรับรหัสภูมิภาคที่ระบุเป็นค่า 2 อักขระ (ไม่ใช่ตัวเลข) ของแท็กย่อยภูมิภาค Unicode ที่แมปกับค่า 2 อักขระของ ccTLD ("โดเมนระดับบนสุด") ที่คุ้นเคย ดูภูมิภาคที่รองรับได้ที่รายละเอียดความครอบคลุมของ Google Maps Platform

โหมด directions

ตัวอย่างต่อไปนี้ใช้โหมด directions เพื่อแสดงเส้นทางระหว่างออสโลและเทเลมาร์ก ประเทศนอร์เวย์ ระยะทาง และระยะเวลาเดินทางโดยหลีกเลี่ยงค่าผ่านทางและทางหลวง

https://www.google.com/maps/embed/v1/directions
  ?key=YOUR_API_KEY
  &origin=Oslo+Norway
  &destination=Telemark+Norway
  &avoid=tolls|highways

คุณใช้พารามิเตอร์ต่อไปนี้ได้

พารามิเตอร์	ประเภท	คำอธิบาย	ค่าที่ยอมรับ
origin	จำเป็น	กำหนดจุดเริ่มต้นที่จะแสดงเส้นทาง	ชื่อสถานที่, ที่อยู่, Plus Code, พิกัดละติจูด/ลองจิจูด หรือรหัสสถานที่ที่ใช้ URL-escape Maps Embed API รองรับทั้ง + และ %20 เมื่อเว้นวรรค เช่น แปลง "City Hall, New York, NY" เป็น City+Hall,New+York,NY หรือ Plus Code "849VCWC8+R9" เป็น 849VCWC8%2BR9
destination	จำเป็น	กำหนดจุดสิ้นสุดของเส้นทาง	ชื่อสถานที่, ที่อยู่, Plus Code, พิกัดละติจูด/ลองจิจูด หรือรหัสสถานที่ที่ใช้ URL-escape Maps Embed API รองรับทั้ง + และ %20 เมื่อเว้นวรรค เช่น แปลง "City Hall, New York, NY" เป็น City+Hall,New+York,NY หรือ Plus Code "849VCWC8+R9" เป็น 849VCWC8%2BR9
waypoints	ไม่บังคับ	ระบุสถานที่ขั้นกลางอย่างน้อย 1 แห่งเพื่อกำหนดเส้นทางระหว่างต้นทางและปลายทาง	ชื่อสถานที่ ที่อยู่ หรือรหัสสถานที่ คุณระบุจุดอ้างอิงหลายจุดได้โดยใช้อักขระไปป์ (|) เพื่อแยกสถานที่ (เช่น Berlin,Germany|Paris,France) คุณระบุจุดอ้างอิงได้สูงสุด 20 จุด
mode	ไม่บังคับ	กำหนดวิธีการเดินทาง หากไม่ได้ระบุโหมด Maps Embed API จะแสดงโหมดที่เกี่ยวข้องมากที่สุดอย่างน้อย 1 โหมดสำหรับเส้นทางที่ระบุ	driving, walking (ซึ่งจะเลือกทางเท้าและทางเดินเท้า หากมี), bicycling (ซึ่งจะเลือกเส้นทางที่ใช้ทางจักรยานและถนนที่แนะนำ หากมี), transit หรือ flying
avoid	ไม่บังคับ	ระบุลักษณะที่ควรหลีกเลี่ยงในเส้นทาง โปรดทราบว่าการดำเนินการนี้ไม่ได้กีดกันเส้นทางที่มีฟีเจอร์ที่ถูกจำกัด แต่จะให้น้ำหนักกับผลลัพธ์ของเส้นทางที่เหมาะสมมากกว่า	tolls, ferries และ/หรือ highways คั่นค่าหลายค่าด้วยอักขระไปป์ (เช่น avoid=tolls|highways)
units	ไม่บังคับ	ระบุวิธีการวัดเป็นเมตริกหรืออิมพีเรียลเมื่อแสดงระยะทางในผลลัพธ์ หากไม่ได้ระบุ units ไว้ origin ประเทศของคำค้นหาจะเป็นตัวกำหนดหน่วยที่จะใช้	metric หรือ imperial
center	ไม่บังคับ	กำหนดจุดศูนย์กลางของมุมมองแผนที่	ยอมรับค่าละติจูดและลองจิจูดที่คั่นด้วยคอมมา เช่น 37.4218,-122.0840
zoom	ไม่บังคับ	กำหนดระดับการซูมเริ่มต้นของแผนที่	ค่าต่างๆ มีตั้งแต่ 0 (ทั้งโลก) ไปจนถึง 21 (อาคารแต่ละหลัง) ขีดจำกัดสูงสุดอาจแตกต่างกันไปตามข้อมูลแผนที่ที่มีอยู่ในตำแหน่งที่เลือก
maptype	ไม่บังคับ	กำหนดประเภทของชิ้นส่วนแผนที่ที่จะโหลด	roadmap (ค่าเริ่มต้น) หรือ satellite
language	ไม่บังคับ	กำหนดภาษาที่จะใช้สำหรับองค์ประกอบ UI และสำหรับการแสดงป้ายกำกับบนชิ้นส่วนแผนที่ โดยค่าเริ่มต้น ผู้เข้าชมจะเห็นแผนที่ในภาษาของตนเอง ระบบรองรับพารามิเตอร์นี้สำหรับไทล์ของบางประเทศเท่านั้น หากไม่รองรับภาษาที่ขอสำหรับชุดไทล์ ระบบจะใช้ภาษาเริ่มต้นสำหรับชุดไทล์นั้น
region	ไม่บังคับ	กำหนดเส้นขอบและป้ายกำกับที่เหมาะสมที่จะแสดงตามความละเอียดอ่อนทางภูมิรัฐศาสตร์	ยอมรับรหัสภูมิภาคที่ระบุเป็นค่า 2 อักขระ (ไม่ใช่ตัวเลข) ของแท็กย่อยภูมิภาค Unicode ที่แมปกับค่า 2 อักขระของ ccTLD ("โดเมนระดับบนสุด") ที่คุ้นเคย ดูภูมิภาคที่รองรับได้ที่รายละเอียดความครอบคลุมของ Google Maps Platform

โหมด streetview

Maps Embed API ช่วยให้คุณแสดงภาพ Street View เป็นภาพพาโนรามาแบบอินเทอร์แอกทีฟจากสถานที่ที่กำหนดทั่วทั้งพื้นที่ครอบคลุมได้ นอกจากนี้ยังมีภาพ Photosphere ที่ผู้ใช้ร่วมให้ข้อมูลและคอลเล็กชันพิเศษของ Street View ด้วย

ภาพพาโนรามาใน Street View แต่ละภาพจะแสดงมุมมอง 360 องศาเต็มรูปแบบจากตำแหน่งเดียว รูปภาพมีมุมมองแนวนอน 360 องศา (รอบทิศทาง) และมุมมองแนวตั้ง 180 องศา (จากบนลงล่าง) โหมด streetview จะแสดงภาพพาโนรามาที่ได้เป็นทรงกลมโดยมีกล้องอยู่ที่จุดศูนย์กลาง คุณสามารถปรับกล้องเพื่อควบคุมการซูมและการวางแนวของกล้องได้

ดูภาพพาโนรามาในโหมด streetview ต่อไปนี้

https://www.google.com/maps/embed/v1/streetview
  ?key=YOUR_API_KEY
  &location=46.414382,10.013988
  &heading=210
  &pitch=10
  &fov=35

ต้องระบุพารามิเตอร์ของ URL รายการใดรายการหนึ่งต่อไปนี้

• location ยอมรับละติจูดและลองจิจูดเป็นค่าที่คั่นด้วยคอมมา (46.414382,10.013988) API จะแสดงภาพพาโนรามาที่ถ่ายไว้ใกล้กับตำแหน่งนี้มากที่สุด เนื่องจากภาพ Street View จะมีการรีเฟรชเป็นระยะๆ และอาจมีการถ่ายภาพจากตำแหน่งที่แตกต่างกันเล็กน้อยในแต่ละครั้ง จึงเป็นไปได้ว่าตำแหน่งของคุณอาจสแนปไปยังภาพพาโนรามาอื่นเมื่อมีการอัปเดตภาพ

• pano คือรหัสพาโนรามาที่เฉพาะเจาะจง หากระบุ pano คุณอาจระบุ location ด้วยก็ได้ ระบบจะใช้ location เฉพาะในกรณีที่ API ไม่พบรหัสพาโนรามา

พารามิเตอร์ของ URL ต่อไปนี้จะใช้หรือไม่ใช้ก็ได้

พารามิเตอร์	ประเภท	คำอธิบาย	ค่าที่ยอมรับ
heading	ไม่บังคับ	ระบุทิศทางเข็มทิศของกล้องเป็นองศาตามเข็มนาฬิกาจากทิศเหนือ	ค่าเป็นองศาตั้งแต่ -180° ถึง 360°
pitch	ไม่บังคับ	ระบุมุมกล้องขึ้นหรือลง ค่าบวกจะปรับมุมกล้องขึ้น ส่วนค่าลบจะปรับมุมกล้องลง ระบบจะตั้งค่าระดับเสียงเริ่มต้นเป็น 0° ตามตำแหน่งของกล้องเมื่อจับภาพ ด้วยเหตุนี้ ระดับความสูง 0° จึงมักจะเป็นแนวนอน แต่ก็ไม่เสมอไป ตัวอย่างเช่น รูปภาพที่ถ่ายบนเนินเขามักจะแสดงระดับการหมุนรอบแกน X เริ่มต้นที่ไม่ใช่แนวนอน	ค่าเป็นองศาตั้งแต่ -90° ถึง 90°
fov	ไม่บังคับ	กำหนดขอบเขตการมองเห็นในแนวนอนของรูปภาพ ค่าเริ่มต้นคือ 90° เมื่อใช้วิวพอร์ตที่มีขนาดคงที่ ขอบเขตการมองเห็นจะถือเป็นระดับการซูม โดยตัวเลขที่น้อยลงจะบ่งบอกถึงระดับการซูมที่สูงขึ้น	ค่าเป็นองศา โดยมีช่วง 10° - 100°
center	ไม่บังคับ	กำหนดจุดศูนย์กลางของมุมมองแผนที่	ยอมรับค่าละติจูดและลองจิจูดที่คั่นด้วยคอมมา เช่น 37.4218,-122.0840
zoom	ไม่บังคับ	กำหนดระดับการซูมเริ่มต้นของแผนที่	ค่าต่างๆ มีตั้งแต่ 0 (ทั้งโลก) ไปจนถึง 21 (อาคารแต่ละหลัง) ขีดจำกัดสูงสุดอาจแตกต่างกันไปตามข้อมูลแผนที่ที่มีอยู่ในตำแหน่งที่เลือก
maptype	ไม่บังคับ	กำหนดประเภทของชิ้นส่วนแผนที่ที่จะโหลด	roadmap (ค่าเริ่มต้น) หรือ satellite
language	ไม่บังคับ	กำหนดภาษาที่จะใช้สำหรับองค์ประกอบ UI และสำหรับการแสดงป้ายกำกับบนชิ้นส่วนแผนที่ โดยค่าเริ่มต้น ผู้เข้าชมจะเห็นแผนที่ในภาษาของตนเอง ระบบรองรับพารามิเตอร์นี้สำหรับไทล์ของบางประเทศเท่านั้น หากไม่รองรับภาษาที่ขอสำหรับชุดไทล์ ระบบจะใช้ภาษาเริ่มต้นสำหรับชุดไทล์นั้น
region	ไม่บังคับ	กำหนดเส้นขอบและป้ายกำกับที่เหมาะสมที่จะแสดงตามความละเอียดอ่อนทางภูมิรัฐศาสตร์	ยอมรับรหัสภูมิภาคที่ระบุเป็นค่า 2 อักขระ (ไม่ใช่ตัวเลข) ของแท็กย่อยภูมิภาค Unicode ที่แมปกับค่า 2 อักขระของ ccTLD ("โดเมนระดับบนสุด") ที่คุ้นเคย ดูภูมิภาคที่รองรับได้ที่รายละเอียดความครอบคลุมของ Google Maps Platform

โหมด search

โหมด Search จะแสดงผลการค้นหาทั่วทั้งภูมิภาคแผนที่ที่มองเห็นได้ ขอแนะนำให้กำหนดสถานที่สำหรับการค้นหา โดยระบุสถานที่ในข้อความค้นหา (record+stores+in+Seattle) หรือระบุพารามิเตอร์ center และ zoom เพื่อจำกัดขอบเขตการค้นหา

https://www.google.com/maps/embed/v1/search
  ?key=YOUR_API_KEY
  &q=record+stores+in+Seattle

คุณใช้พารามิเตอร์ต่อไปนี้ได้

พารามิเตอร์	ประเภท	คำอธิบาย	ค่าที่ยอมรับ
q	จำเป็น	กำหนดข้อความค้นหา	ซึ่งอาจรวมถึงข้อจำกัดทางภูมิศาสตร์ เช่น in+Seattle หรือ near+98033
center	ไม่บังคับ	กำหนดจุดศูนย์กลางของมุมมองแผนที่	ยอมรับค่าละติจูดและลองจิจูดที่คั่นด้วยคอมมา เช่น 37.4218,-122.0840
zoom	ไม่บังคับ	กำหนดระดับการซูมเริ่มต้นของแผนที่	ค่าต่างๆ มีตั้งแต่ 0 (ทั้งโลก) ไปจนถึง 21 (อาคารแต่ละหลัง) ขีดจำกัดสูงสุดอาจแตกต่างกันไปตามข้อมูลแผนที่ที่มีอยู่ในตำแหน่งที่เลือก
maptype	ไม่บังคับ	กำหนดประเภทของชิ้นส่วนแผนที่ที่จะโหลด	roadmap (ค่าเริ่มต้น) หรือ satellite
language	ไม่บังคับ	กำหนดภาษาที่จะใช้สำหรับองค์ประกอบ UI และสำหรับการแสดงป้ายกำกับบนชิ้นส่วนแผนที่ โดยค่าเริ่มต้น ผู้เข้าชมจะเห็นแผนที่ในภาษาของตนเอง ระบบรองรับพารามิเตอร์นี้สำหรับไทล์ของบางประเทศเท่านั้น หากไม่รองรับภาษาที่ขอสำหรับชุดไทล์ ระบบจะใช้ภาษาเริ่มต้นสำหรับชุดไทล์นั้น
region	ไม่บังคับ	กำหนดเส้นขอบและป้ายกำกับที่เหมาะสมที่จะแสดงตามความละเอียดอ่อนทางภูมิรัฐศาสตร์	ยอมรับรหัสภูมิภาคที่ระบุเป็นค่า 2 อักขระ (ไม่ใช่ตัวเลข) ของแท็กย่อยภูมิภาค Unicode ที่แมปกับค่า 2 อักขระของ ccTLD ("โดเมนระดับบนสุด") ที่คุ้นเคย ดูภูมิภาคที่รองรับได้ที่รายละเอียดความครอบคลุมของ Google Maps Platform

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

Maps Embed API รองรับการใช้รหัสสถานที่แทนการระบุชื่อหรือที่อยู่ของสถานที่ รหัสสถานที่เป็นวิธีที่เสถียรในการระบุสถานที่โดยไม่ซ้ำกัน ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบเกี่ยวกับ Places API (ใหม่)

Maps Embed API ยอมรับรหัสสถานที่สำหรับพารามิเตอร์ของ URL ต่อไปนี้

• q
• origin
• destination
• waypoints

หากต้องการใช้รหัสสถานที่ คุณต้องเพิ่มคำนำหน้า place_id: ก่อน โค้ดต่อไปนี้ระบุศาลาว่าการนครนิวยอร์กเป็นจุดเริ่มต้นของคำขอเส้นทาง: origin=place_id:ChIJs--MqP1YwokRBwAhjXWIHn8

• radius กำหนดรัศมีเป็นเมตรเพื่อค้นหาภาพพาโนรามา โดยมีศูนย์กลางอยู่ที่ละติจูดและลองจิจูดที่ระบุ ค่าที่ถูกต้องคือจำนวนเต็มที่ไม่ติดลบ ค่าเริ่มต้นคือ 50

• source จำกัดการค้นหา Street View ไว้เฉพาะแหล่งที่มาที่เลือก ค่าที่ใช้ได้มีดังนี้

  • default ใช้แหล่งที่มาเริ่มต้นสำหรับ Street View โดยการค้นหาจะไม่จำกัดเฉพาะแหล่งที่มาที่เจาะจง
  • outdoor จำกัดการค้นหาไว้ที่คอลเล็กชันกลางแจ้ง คอลเล็กชันในอาคารจะไม่รวมอยู่ในผลการค้นหา โปรดทราบว่าอาจไม่มีภาพพาโนรามากลางแจ้งสำหรับสถานที่ที่ระบุ โปรดทราบว่าการค้นหาจะแสดงเฉพาะภาพพาโนรามาที่ระบุได้ว่าเป็นภาพในอาคารหรือกลางแจ้ง ตัวอย่างเช่น ระบบจะไม่แสดงผล PhotoSphere เนื่องจากไม่ทราบว่าอยู่ภายในหรือภายนอกอาคาร