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

คู่มือนี้แสดงวิธีฝังแผนที่เชิงโต้ตอบในหน้าเว็บของคุณ

การสร้าง 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
  &center=-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 กําหนดรัศมี (หน่วยเป็นเมตร) เพื่อใช้ค้นหาพาโนรามา ซึ่งมีศูนย์กลางอยู่ที่ละติจูดและลองจิจูดที่กําหนด ค่าที่ถูกต้องคือจํานวนเต็มที่ไม่เป็นลบ ค่าเริ่มต้นคือ 50

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

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