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

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

การสร้าง 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 เพื่อแสดงเส้นทางระหว่างออสโลกับเทเลมาร์กในนอร์เวย์ ระยะทาง และเวลาเดินทางโดยหลีกเลี่ยงการเรียกเก็บเงินค่าผ่านทางและทางหลวง

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

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

Maps Embed API รองรับการใช้รหัสสถานที่แทนการระบุชื่อหรือที่อยู่สถานที่ รหัสสถานที่เป็นวิธีแบบคงที่ในการไม่ซ้ำกัน ระบุสถานที่ โปรดดูข้อมูลเพิ่มเติมในเอกสารประกอบของ Google 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 จำกัดการค้นหาไว้สำหรับคอลเล็กชันกลางแจ้ง ผลงานในอาคารจะไม่รวมอยู่ในผลการค้นหา โปรดทราบว่าภาพพาโนรามากลางแจ้ง ไม่มีอยู่สำหรับตำแหน่งที่ระบุ โปรดทราบด้วยว่า การค้นหาจะ จะแสดงภาพพาโนรามาที่ทราบว่าอยู่ในอาคารหรือไม่ หรือกลางแจ้ง เช่น ระบบจะไม่แสดงภาพ 360 องศาเนื่องจากไม่ทราบว่าเป็นภาพภายในหรือภายนอก