การฝังแผนที่

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

การสร้าง 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="no-referrer-when-downgrade"
  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="no-referrer-when-downgrade" เพื่อให้ เพื่อส่ง URL แบบเต็มเป็นส่วนหัว Referer พร้อมกับคำขอ ข้อจำกัดของคีย์ API อาจทำงานได้อย่างถูกต้อง

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

ข้อจำกัดของคีย์ API

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

โฆษณาบนแผนที่

Maps Embed API อาจรวมการลงโฆษณาบนแผนที่ รูปแบบโฆษณาและ ชุดของโฆษณาที่แสดงในแผนที่หนึ่งๆ อาจเปลี่ยนแปลงโดยไม่ต้องแจ้งให้ทราบล่วงหน้า

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

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

โหมด directions

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

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

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

พารามิเตอร์ ประเภท คำอธิบาย ค่าที่ยอมรับ
origin จำเป็น กำหนดจุดเริ่มต้นเพื่อแสดงเส้นทาง ชื่อสถานที่ ที่อยู่ โค้ดที่ใช้อักขระหลีกกับ URL, ละติจูด/ลองจิจูด พิกัด หรือรหัสสถานที่ Maps Embed API รองรับทั้ง + และ %20 เมื่อออกจากช่องว่าง เช่น แปลง "ศาลาว่าการ นิวยอร์ก นิวยอร์ก" ถึง City+Hall,New+York,NY หรือรหัส Plus "849VCWC8+R9" ถึง 849VCWC8%2BR9.
destination จำเป็น กำหนดจุดสิ้นสุดของเส้นทาง ชื่อสถานที่ ที่อยู่ โค้ดที่ใช้อักขระหลีกกับ URL, ละติจูด/ลองจิจูด พิกัด หรือรหัสสถานที่ Maps Embed API รองรับทั้ง + และ %20 เมื่อออกจากช่องว่าง เช่น แปลง "ศาลาว่าการ นิวยอร์ก นิวยอร์ก" ถึง City+Hall,New+York,NY หรือรหัส Plus "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 กับ ccTLD ที่คุ้นเคย ("โดเมนระดับบนสุด") ซึ่งมีอักขระ 2 ตัว โปรดดู 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 ไม่พบพาโนรามาเท่านั้น ID

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

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

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

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

Maps Embed API ยอมรับรหัสสถานที่ของ URL ต่อไปนี้ ได้แก่

  • q
  • origin
  • destination
  • waypoints

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

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

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

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