คู่มือนี้แสดงวิธีฝังแผนที่แบบอินเทอร์แอกทีฟลงในหน้าเว็บของคุณ
การสร้าง 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
คุณใช้พารามิเตอร์ต่อไปนี้ได้
พารามิเตอร์ | Type | คำอธิบาย | ค่าที่ยอมรับ |
---|---|---|---|
q |
จำเป็น | กำหนดตำแหน่งของเครื่องหมายบนแผนที่ | ชื่อสถานที่ ที่อยู่ โค้ด Plus หรือรหัสสถานที่ที่ใช้อักขระหลีกกับ URL
Maps Embed API รองรับทั้ง + และ %20 เมื่อออกจากพื้นที่ทำงาน ตัวอย่างเช่น แปลง "City Hall, New York, NY" เป็น 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 อักขระ (ไม่ใช่ตัวเลข) กับค่า 2 อักขระ ccTLD ที่คุ้นเคย ดูรายละเอียดการครอบคลุมของ 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
คุณใช้พารามิเตอร์ต่อไปนี้ได้
พารามิเตอร์ | Type | คำอธิบาย | ค่าที่ยอมรับ |
---|---|---|---|
center |
จำเป็น | กำหนดศูนย์กลางของมุมมองแผนที่ | ยอมรับค่าละติจูดและลองจิจูดที่คั่นด้วยคอมมา เช่น 37.4218,-122.0840 |
zoom |
ไม่บังคับ | ตั้งค่าระดับการซูมเริ่มต้นของแผนที่ | ค่าตั้งแต่ 0 (ทั่วโลก) ถึง 21 (แต่ละอาคาร) ขีดจำกัดสูงสุดอาจแตกต่างกันไปโดยขึ้นอยู่กับข้อมูลแผนที่ที่มีอยู่ในตำแหน่งที่เลือก |
maptype |
ไม่บังคับ | กำหนดประเภทของแผนที่ย่อยที่จะโหลด | roadmap (ค่าเริ่มต้น) หรือ satellite |
language |
ไม่บังคับ | กำหนดภาษาที่จะใช้สำหรับองค์ประกอบ UI และการแสดงป้ายกำกับบนชิ้นส่วนแผนที่ โดยค่าเริ่มต้น ผู้เข้าชมจะใช้แผนที่ในภาษาของตนเอง พารามิเตอร์นี้รองรับการ์ดประเทศบางรายการเท่านั้น หากชุดการ์ดไม่รองรับภาษาที่ขออย่างเจาะจง ระบบจะใช้ภาษาเริ่มต้นสำหรับชุดการ์ดดังกล่าว | |
region |
ไม่บังคับ | กำหนดพรมแดนและป้ายกำกับที่เหมาะสมที่จะแสดง โดยอิงตามความละเอียดอ่อนด้านภูมิศาสตร์การเมือง | ยอมรับรหัสภูมิภาคที่ระบุเป็นการจับคู่แท็กย่อยภูมิภาค 2 อักขระ (ไม่ใช่ตัวเลข) กับค่า 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
คุณใช้พารามิเตอร์ต่อไปนี้ได้
พารามิเตอร์ | Type | คำอธิบาย | ค่าที่ยอมรับ |
---|---|---|---|
origin |
จำเป็น | กำหนดจุดเริ่มต้นที่จะแสดงเส้นทาง | ชื่อสถานที่ ที่อยู่ โค้ด Plus พิกัดละติจูด/ลองจิจูด หรือรหัสสถานที่ที่ออกจาก URL
Maps Embed API รองรับทั้ง + และ %20 เมื่อออกจากพื้นที่ทำงาน ตัวอย่างเช่น แปลง "City Hall, New York, NY" เป็น City+Hall,New+York,NY หรือ Plus รหัส "849VCWC8+R9" เป็น 849VCWC8%2BR9 |
destination |
จำเป็น | กำหนดจุดสิ้นสุดของเส้นทาง | ชื่อสถานที่ ที่อยู่ โค้ด Plus พิกัดละติจูด/ลองจิจูด หรือรหัสสถานที่ที่ออกจาก URL
Maps Embed API รองรับทั้ง + และ %20 เมื่อออกจากพื้นที่ทำงาน ตัวอย่างเช่น แปลง "City Hall, New York, NY" เป็น 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 อักขระ (ไม่ใช่ตัวเลข) กับค่า 2 อักขระ ccTLD ที่คุ้นเคย ดูรายละเอียดการครอบคลุมของ 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 อย่างน้อย 1 รายการ
location
ยอมรับละติจูดและลองจิจูดเป็นค่าที่คั่นด้วยคอมมา (46.414382,10.013988
) API จะแสดงภาพพาโนรามาที่อยู่ใกล้กับสถานที่นี้มากที่สุด เนื่องจากภาพ Street View จะรีเฟรชเป็นระยะๆ และอาจถ่ายจากตำแหน่งที่ต่างกันเล็กน้อยในแต่ละครั้ง เป็นไปได้ว่าตำแหน่งของคุณอาจสแนปไปยังภาพพาโนรามาที่แตกต่างกันเมื่ออัปเดตภาพpano
คือรหัสพาโนรามาที่เฉพาะเจาะจง หากระบุpano
คุณอาจระบุlocation
ด้วย ระบบจะใช้location
เมื่อ API ไม่พบรหัสพาโนรามาเท่านั้น
คุณจะใช้พารามิเตอร์ของ URL ต่อไปนี้หรือไม่ก็ได้
พารามิเตอร์ | Type | คำอธิบาย | ค่าที่ยอมรับ |
---|---|---|---|
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 อักขระ (ไม่ใช่ตัวเลข) กับค่า 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
คุณใช้พารามิเตอร์ต่อไปนี้ได้
พารามิเตอร์ | Type | คำอธิบาย | ค่าที่ยอมรับ |
---|---|---|---|
q |
จำเป็น | กำหนดข้อความค้นหา | ซึ่งอาจมีข้อจำกัดทางภูมิศาสตร์ เช่น in+Seattle หรือ near+98033 |
center |
ไม่บังคับ | กำหนดศูนย์กลางของมุมมองแผนที่ | ยอมรับค่าละติจูดและลองจิจูดที่คั่นด้วยคอมมา เช่น 37.4218,-122.0840 |
zoom |
ไม่บังคับ | ตั้งค่าระดับการซูมเริ่มต้นของแผนที่ | ค่าตั้งแต่ 0 (ทั่วโลก) ถึง 21 (แต่ละอาคาร) ขีดจำกัดสูงสุดอาจแตกต่างกันไปโดยขึ้นอยู่กับข้อมูลแผนที่ที่มีอยู่ในตำแหน่งที่เลือก |
maptype |
ไม่บังคับ | กำหนดประเภทของแผนที่ย่อยที่จะโหลด | roadmap (ค่าเริ่มต้น) หรือ satellite |
language |
ไม่บังคับ | กำหนดภาษาที่จะใช้สำหรับองค์ประกอบ UI และการแสดงป้ายกำกับบนชิ้นส่วนแผนที่ โดยค่าเริ่มต้น ผู้เข้าชมจะใช้แผนที่ในภาษาของตนเอง พารามิเตอร์นี้รองรับการ์ดประเทศบางรายการเท่านั้น หากชุดการ์ดไม่รองรับภาษาที่ขออย่างเจาะจง ระบบจะใช้ภาษาเริ่มต้นสำหรับชุดการ์ดดังกล่าว | |
region |
ไม่บังคับ | กำหนดพรมแดนและป้ายกำกับที่เหมาะสมที่จะแสดง โดยอิงตามความละเอียดอ่อนด้านภูมิศาสตร์การเมือง | ยอมรับรหัสภูมิภาคที่ระบุเป็นการจับคู่แท็กย่อยภูมิภาค 2 อักขระ (ไม่ใช่ตัวเลข) กับค่า 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
กำหนดรัศมี โดยมีหน่วยเป็นเมตรเพื่อค้นหาพาโนรามา โดยมีศูนย์กลางอยู่ที่ละติจูดและลองจิจูดที่กำหนด ค่าที่ถูกต้อง เป็นจำนวนเต็มที่ไม่เป็นลบ ค่าเริ่มต้นคือ 50source
จำกัดการค้นหา Street View เฉพาะแหล่งที่มาที่เลือก ค่าที่ใช้ได้มีดังนี้default
ใช้แหล่งที่มาเริ่มต้นสำหรับ Street View การค้นหาไม่ได้จำกัดแค่บางแหล่งที่มาoutdoor
จำกัดการค้นหาไว้เฉพาะคอลเล็กชันกลางแจ้ง คอลเล็กชันในอาคารจะไม่รวมอยู่ในผลการค้นหา โปรดทราบว่าภาพพาโนรามากลางแจ้ง อาจไม่มีอยู่ในสถานที่ที่ระบุ นอกจากนี้ โปรดทราบว่าการค้นหาจะแสดงเฉพาะภาพพาโนรามาที่คุณสามารถระบุได้ว่าอยู่ในร่มหรือกลางแจ้ง เช่น ไม่มีการส่งคืน PhotoSpheres เพราะไม่รู้ว่ารูปภาพอยู่ในอาคารหรือกลางแจ้ง