คู่มือนี้แสดงวิธีฝังแผนที่แบบอินเทอร์แอกทีฟลงในหน้าเว็บ
สร้าง 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
เลือกโหมดแผนที่
คุณระบุโหมดแผนที่ต่อไปนี้อย่างใดอย่างหนึ่งเพื่อใช้ใน 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
Maps Embed API รองรับทั้ง + และ %20
เมื่อหลีกเลี่ยงช่องว่าง เช่น แปลง "City Hall, New York, NY" เป็น
City+Hall,New+York,NY หรือแปลง Plus Codes "849VCWC8+R9" เป็น
849VCWC8%2BR9 |
center |
ไม่บังคับ | กำหนดศูนย์กลางของมุมมองแผนที่ | ยอมรับค่าละติจูดและลองจิจูดที่คั่นด้วยคอมมา เช่น
37.4218,-122.0840 |
zoom |
ไม่บังคับ | กำหนดระดับการซูมเริ่มต้นของแผนที่ | ค่าตั้งแต่ 0 (ทั้งโลก) ถึง 21
(อาคารแต่ละหลัง) ขีดจำกัดบนอาจแตกต่างกันไปตามข้อมูลแผนที่
ที่มีในสถานที่ที่เลือก |
maptype |
ไม่บังคับ | กำหนดประเภทแผนที่ที่จะโหลด | roadmap (ค่าเริ่มต้น) หรือ satellite |
language |
ไม่บังคับ | กำหนดภาษาที่จะใช้สำหรับองค์ประกอบ UI และสำหรับการแสดงป้ายกำกับในไทล์แผนที่ โดยค่าเริ่มต้น ผู้เข้าชมจะเห็นแผนที่เป็นภาษาของตนเอง พารามิเตอร์นี้รองรับเฉพาะบางการ์ดประเทศ หากชุดการ์ดไม่รองรับภาษาที่เฉพาะเจาะจงที่ขอ ระบบจะใช้ภาษาเริ่มต้นสำหรับชุดการ์ดนั้น | |
region |
ไม่บังคับ | กำหนดเส้นขอบและป้ายกำกับที่เหมาะสมเพื่อแสดงตาม ความละเอียดอ่อนทางภูมิรัฐศาสตร์ | ยอมรับรหัสภูมิภาคที่ระบุเป็นแท็กย่อยของภูมิภาค Unicode แบบ 2 อักขระ (ไม่ใช่ตัวเลข) ซึ่งแมปกับค่า ccTLD ("โดเมนระดับบนสุด") แบบ 2 อักขระที่คุ้นเคย ดูภูมิภาคที่รองรับได้ที่รายละเอียดความครอบคลุมของ Google Maps Platform |
โหมด view
ตัวอย่างต่อไปนี้ใช้view
โหมดและพารามิเตอร์ maptype
ที่ไม่บังคับเพื่อ
แสดงมุมมองจากดาวเทียมของแผนที่
https://www.google.com/maps/embed/v1/view
?key=YOUR_API_KEY
¢er=-33.8569,151.2152
&zoom=18
&maptype=satellite
คุณใช้พารามิเตอร์ต่อไปนี้ได้
พารามิเตอร์ | ประเภท | คำอธิบาย | ค่าที่ยอมรับ |
---|---|---|---|
center |
จำเป็น | กำหนดศูนย์กลางของมุมมองแผนที่ | ยอมรับค่าละติจูดและลองจิจูดที่คั่นด้วยคอมมา เช่น
37.4218,-122.0840 |
zoom |
ไม่บังคับ | กำหนดระดับการซูมเริ่มต้นของแผนที่ | ค่าตั้งแต่ 0 (ทั้งโลก) ถึง 21
(อาคารแต่ละหลัง) ขีดจำกัดบนอาจแตกต่างกันไปตามข้อมูลแผนที่
ที่มีในสถานที่ที่เลือก |
maptype |
ไม่บังคับ | กำหนดประเภทแผนที่ที่จะโหลด | roadmap (ค่าเริ่มต้น) หรือ satellite |
language |
ไม่บังคับ | กำหนดภาษาที่จะใช้สำหรับองค์ประกอบ UI และสำหรับการแสดงป้ายกำกับในไทล์แผนที่ โดยค่าเริ่มต้น ผู้เข้าชมจะเห็นแผนที่เป็นภาษาของตนเอง พารามิเตอร์นี้รองรับเฉพาะบางการ์ดประเทศ หากชุดการ์ดไม่รองรับภาษาที่เฉพาะเจาะจงที่ขอ ระบบจะใช้ภาษาเริ่มต้นสำหรับชุดการ์ดนั้น | |
region |
ไม่บังคับ | กำหนดเส้นขอบและป้ายกำกับที่เหมาะสมเพื่อแสดงตาม ความละเอียดอ่อนทางภูมิรัฐศาสตร์ | ยอมรับรหัสภูมิภาคที่ระบุเป็นแท็กย่อยของภูมิภาค Unicode แบบ 2 อักขระ (ไม่ใช่ตัวเลข) ซึ่งแมปกับค่า 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" เป็น
City+Hall,New+York,NY หรือแปลง Plus Codes "849VCWC8+R9" เป็น
849VCWC8%2BR9 |
destination |
จำเป็น | กำหนดจุดสิ้นสุดของเส้นทาง | ชื่อสถานที่ ที่อยู่ Plus Code พิกัดละติจูด/ลองจิจูด หรือรหัสสถานที่ที่หลีกเลี่ยง URL
Maps Embed API รองรับทั้ง + และ %20
เมื่อหลีกเลี่ยงช่องว่าง เช่น แปลง "City Hall, New York, NY" เป็น
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 |
ไม่บังคับ | กำหนดเส้นขอบและป้ายกำกับที่เหมาะสมเพื่อแสดงตาม ความละเอียดอ่อนทางภูมิรัฐศาสตร์ | ยอมรับรหัสภูมิภาคที่ระบุเป็นแท็กย่อยของภูมิภาค Unicode แบบ 2 อักขระ (ไม่ใช่ตัวเลข) ซึ่งแมปกับค่า ccTLD ("โดเมนระดับบนสุด") แบบ 2 อักขระที่คุ้นเคย ดูภูมิภาคที่รองรับได้ที่รายละเอียดความครอบคลุมของ Google Maps Platform |
โหมด streetview
Maps Embed API ช่วยให้คุณแสดงรูปภาพ Street View เป็น พาโนรามาแบบอินเทอร์แอกทีฟจากสถานที่ที่กำหนดทั่วทั้ง พื้นที่ครอบคลุม นอกจากนี้ยังมีภาพทรงกลมจากผู้ใช้และคอลเล็กชันพิเศษของ 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 ต่อไปนี้อย่างน้อย 1 รายการ
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 |
ไม่บังคับ | กำหนดเส้นขอบและป้ายกำกับที่เหมาะสมเพื่อแสดงตาม ความละเอียดอ่อนทางภูมิรัฐศาสตร์ | ยอมรับรหัสภูมิภาคที่ระบุเป็นแท็กย่อยของภูมิภาค Unicode แบบ 2 อักขระ (ไม่ใช่ตัวเลข) ซึ่งแมปกับค่า 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 |
ไม่บังคับ | กำหนดเส้นขอบและป้ายกำกับที่เหมาะสมเพื่อแสดงตาม ความละเอียดอ่อนทางภูมิรัฐศาสตร์ | ยอมรับรหัสภูมิภาคที่ระบุเป็นแท็กย่อยของภูมิภาค Unicode แบบ 2 อักขระ (ไม่ใช่ตัวเลข) ซึ่งแมปกับค่า ccTLD ("โดเมนระดับบนสุด") แบบ 2 อักขระที่คุ้นเคย ดูภูมิภาคที่รองรับได้ที่รายละเอียดความครอบคลุมของ 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
กำหนดรัศมีเป็นเมตรเพื่อค้นหาภาพพาโนรามาซึ่งมีศูนย์กลางอยู่ที่ละติจูดและลองจิจูดที่ระบุ ค่าที่ถูกต้อง คือจำนวนเต็มที่ไม่ติดลบ ค่าเริ่มต้นคือ 50source
จำกัดการค้นหา Street View ให้แสดงเฉพาะแหล่งที่มาที่เลือก ค่าที่ใช้ได้มีดังนี้default
ใช้แหล่งที่มาเริ่มต้นสำหรับ Street View โดยการค้นหาไม่ได้จำกัดอยู่เพียงแหล่งที่มาใดแหล่งที่มาหนึ่งoutdoor
จำกัดการค้นหาเฉพาะคอลเล็กชันกลางแจ้ง คอลเล็กชันในอาคาร จะไม่รวมอยู่ในผลการค้นหา โปรดทราบว่าพาโนรามากลางแจ้ง อาจไม่มีสำหรับสถานที่ที่ระบุ นอกจากนี้ โปรดทราบว่าการค้นหาจะแสดงเฉพาะภาพพาโนรามาที่สามารถระบุได้ว่าเป็นภาพในอาคารหรือนอกอาคาร เช่น ระบบจะไม่แสดง Photo Sphere เนื่องจากไม่ทราบว่าอยู่ภายในหรือภายนอกอาคาร