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