เริ่มต้นใช้งาน

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

บทนำ

URL ของ Maps ช่วยให้คุณสามารถสร้าง URL ข้ามแพลตฟอร์มเพื่อเปิดตัว Google Maps และทําการค้นหา ขอเส้นทางและการนําทาง รวมทั้งแสดงมุมมองแผนที่และรูปภาพพาโนรามา ไวยากรณ์ของ URL จะเหมือนกันไม่ว่าจะใช้แพลตฟอร์มใด

คุณไม่จําเป็นต้องใช้คีย์ Google API เพื่อใช้ URL ของ Maps

ไวยากรณ์ข้ามแพลตฟอร์มสากล

ในฐานะนักพัฒนาแอป Android, แอป iOS หรือเว็บไซต์ คุณจะสร้าง URL ทั่วไปได้ แล้ว URL ดังกล่าวจะเปิด Google Maps และดําเนินการตามที่ขอ ไม่ว่าจะใช้แพลตฟอร์มใดก็ตามเมื่อเปิดแผนที่

  • ในอุปกรณ์ Android ให้ทําดังนี้
    • หากติดตั้ง แอป Google Maps สําหรับ Android ไว้ URL จะเปิด Google Maps ในแอป Maps และดําเนินการตามคําขอ
    • หากไม่ได้ติดตั้งแอป Google Maps ไว้หรือปิดใช้ URL นี้จะเปิดใช้ Google Maps ในเบราว์เซอร์และดําเนินการตามคําขอ
  • ในอุปกรณ์ iOS ให้ทําดังนี้
    • หากติดตั้งแอป Google Maps สําหรับ iOS ไว้ URL จะเปิด Google Maps ในแอป Maps และดําเนินการ ที่ขอ
    • หากไม่ได้ติดตั้งแอป Google Maps ไว้ URL จะเปิดใช้ Google Maps ในเบราว์เซอร์และดําเนินการตามคําขอ
  • ในอุปกรณ์อื่นๆ URL ดังกล่าวจะเปิด Google Maps ในเบราว์เซอร์และดําเนินการตามคําขอ

ขอแนะนําให้คุณใช้ URL ข้ามแพลตฟอร์มในการเปิดตัว Google Maps จากแอปหรือเว็บไซต์ของคุณ เนื่องจาก URL สากลเหล่านี้ให้การจัดการคําขอแผนที่ในวงกว้างขึ้นไม่ว่าจะใช้แพลตฟอร์มใดอยู่ สําหรับฟีเจอร์ที่ใช้งานได้เฉพาะในแพลตฟอร์มอุปกรณ์เคลื่อนที่ (เช่น การนําทางแบบเลี้ยวต่อเลี้ยว) คุณอาจต้องการใช้ตัวเลือกเฉพาะแพลตฟอร์มสําหรับ Android หรือ iOS โปรดดูเอกสารประกอบต่อไปนี้

การเปิดตัว Google Maps และการดําเนินการที่เฉพาะเจาะจง

หากต้องการเปิด Google Maps และใช้ฟังก์ชันใดฟังก์ชันหนึ่งที่รองรับ ให้ใช้รูปแบบ URL รูปแบบใดรูปแบบหนึ่งต่อไปนี้ ขึ้นอยู่กับการดําเนินการที่ขอ

  • ค้นหา — เปิด Google Maps ที่แสดงหมุดของสถานที่หนึ่งๆ หรือทําการค้นหาทั่วไปแล้วเปิดใช้แผนที่เพื่อแสดงผลลัพธ์ ดังนี้
    https://www.google.com/maps/search/?api=1&parameters
  • เส้นทาง — ขอเส้นทางและเปิดตัว Google Maps ที่มีผลลัพธ์ต่อไปนี้
    https://www.google.com/maps/dir/?api=1&parameters
  • แสดงแผนที่ — เปิด Google Maps โดยไม่มีเครื่องหมายหรือเส้นทาง
    https://www.google.com/maps/@?api=1&map_action=map&parameters
  • แสดงพาโนรามา Street View — เปิดใช้รูปภาพพาโนรามาแบบอินเทอร์แอกทีฟดังนี้
    https://www.google.com/maps/@?api=1&map_action=pano&parameters

สําคัญ: พารามิเตอร์ api=1 จะระบุเวอร์ชันของ URL Maps ที่ URL นี้ต้องการ ต้องระบุพารามิเตอร์นี้ในคําขอทุกรายการ ค่าที่ใช้ได้คือ 1 หาก api=1 ไม่มีอยู่ใน URL ระบบจะไม่สนใจพารามิเตอร์ทั้งหมด และระบบจะเปิดแอป Google Maps เริ่มต้นไม่ว่าจะในเบราว์เซอร์หรือแอป Google Maps บนอุปกรณ์เคลื่อนที่ ซึ่งขึ้นอยู่กับแพลตฟอร์มที่ใช้งาน (เช่น https://www.google.com/maps)

การสร้าง URL ที่ถูกต้อง

คุณต้องเข้ารหัส URL ให้ถูกต้อง

เช่น พารามิเตอร์บางอย่างใช้อักขระไปป์ (|) เป็นตัวคั่น ซึ่งคุณจะต้องเข้ารหัสเป็น %7C ใน URL สุดท้าย พารามิเตอร์อื่นๆ ใช้ค่าที่คั่นด้วยคอมมา เช่น พิกัดละติจูด/ลองจิจูดหรือเมือง รัฐ คุณต้องเข้ารหัสคอมมาเป็น %2C เข้ารหัสพื้นที่ทํางานด้วย %20 หรือแทนที่ด้วยเครื่องหมายบวก (+)

นอกจากนี้ URL แต่ละคําขอมีจํานวนอักขระได้ไม่เกิน 2,048 ตัว โปรดคํานึงถึงขีดจํากัดนี้เมื่อสร้าง URL

การทำงานบนแผนที่

การทํางานในแผนที่ ได้แก่ การค้นหา เส้นทาง แสดงแผนที่ และแสดงพาโนรามา Street View คุณระบุการดําเนินการใน URL คําขอ รวมถึงพารามิเตอร์ที่จําเป็นและไม่บังคับได้ มาตรฐานใน URL ช่วยให้คุณแยกพารามิเตอร์โดยใช้เครื่องหมายแอมเพอร์แซนด์ (&) สําหรับการดําเนินการแต่ละรายการ รายการพารามิเตอร์และค่าที่อาจมีการแจกแจงอยู่ในส่วนพารามิเตอร์การค้นหา

ค้นหา

การดําเนินการค้นหาแสดงผลการค้นหาสําหรับการค้นหาในภูมิภาคในแผนที่ที่มองเห็นได้ เมื่อค้นหาสถานที่หนึ่งๆ แผนที่ที่ได้จะแสดงหมุดไว้ในตําแหน่งที่ระบุ และแสดงรายละเอียดสถานที่ที่มี

การสร้าง URL การค้นหา

https://www.google.com/maps/search/?api=1&parameters

พารามิเตอร์

  • query (ต้องระบุ): กําหนดสถานที่ที่จะไฮไลต์บนแผนที่ ต้องมีพารามิเตอร์การค้นหาสําหรับคําขอการค้นหาทั้งหมด
    • ระบุสถานที่เป็นชื่อสถานที่ ที่อยู่ หรือพิกัดละติจูด/ลองจิจูดที่คั่นด้วยเครื่องหมายจุลภาค สตริงควรเข้ารหัสด้วย URL ดังนั้นควรแปลงที่อยู่อย่างเช่น "City Hall, New York, NY" เป็น City+Hall%2C+New+York%2C+NY
    • ระบุข้อความค้นหาทั่วไปเป็นสตริงที่เข้ารหัส URL เช่น grocery+stores หรือ restaurants+in+seattle+wa
  • query_place_id (ไม่บังคับ): รหัสสถานที่คือตัวระบุที่เป็นข้อความซึ่งใช้ระบุสถานที่ได้โดยไม่ซ้ํากัน สําหรับการดําเนินการ search คุณต้องระบุ query แต่อาจระบุ query_place_id ด้วย หากคุณระบุพารามิเตอร์ทั้ง 2 ตัว ระบบจะใช้ query เฉพาะในกรณีที่ Google Maps ไม่พบรหัสสถานที่ หากคุณพยายามระบุสถานที่เฉพาะอย่างชัดเจน รหัสสถานที่จะช่วยให้มั่นใจได้ว่าคุณจะลิงก์ไปยังสถานที่ที่ถูกต้อง นอกจากนี้ ขอแนะนําให้ส่ง query_place_id เมื่อคุณค้นหาตําแหน่งที่เจาะจงโดยใช้พิกัดละติจูดและลองจิจูด

ตัวอย่างการค้นหา

การค้นหาสถานที่ตั้ง

ในการค้นหาตําแหน่ง คุณจะค้นหาสถานที่แบบเจาะจงโดยใช้ชื่อสถานที่ ที่อยู่ หรือพิกัดละติจูด/ลองจิจูดโดยคั่นด้วยเครื่องหมายจุลภาค และแผนที่ที่ได้จะแสดงหมุดที่ตําแหน่งนั้น ตัวอย่าง 3 รายการนี้แสดงตัวอย่างการค้นหาสถานที่ตั้งเดียวกัน ซึ่งก็คือ CenturyLink Field (สนามกีฬาในซีแอตเทิล รัฐวอชิงตัน) ที่ใช้ค่าตําแหน่งที่แตกต่างกัน

ตัวอย่างที่ 1: การค้นหาชื่อสถานที่ "CenturyLink Field" ได้ผลลัพธ์ในแผนที่ต่อไปนี้

https://www.google.com/maps/search/?api=1&query=centurylink+field

ตัวอย่างที่ 2: การค้นหาช่อง CenturyLink โดยใช้พิกัดละติจูดและลองจิจูด รวมถึงผลลัพธ์ของรหัสสถานที่ในแผนที่ต่อไปนี้

https://www.google.com/maps/search/?api=1&query=47.5951518%2C-122.3316393&query_place_id=ChIJKxjxuaNqkFQR3CK6O1HNNqY

ตัวอย่างที่ 3: การค้นหาช่อง CenturyLink โดยใช้พิกัดละติจูด/ลองจิจูดจะทําให้ได้รับแผนที่ต่อไปนี้ สังเกตว่ามีหมุดในแผนที่แต่ไม่ได้ให้ข้อมูลสถานที่เพิ่มเติมไว้บนแผนที่หรือในแผงด้านข้าง

https://www.google.com/maps/search/?api=1&query=47.5951518%2C-122.3316393

การค้นหาตามหมวดหมู่

ในการค้นหาตามหมวดหมู่ คุณจะส่งข้อความค้นหาทั่วไป และ Google Maps จะพยายามค้นหารายการที่ตรงกับเกณฑ์ของคุณที่อยู่ใกล้กับสถานที่ที่คุณระบุ หากไม่ได้ระบุตําแหน่งไว้ Google Maps จะพยายามค้นหารายชื่อใกล้เคียง ตําแหน่งปัจจุบันของคุณ หากต้องการระบุตําแหน่งสําหรับการค้นหาตามหมวดหมู่ ให้ใส่ตําแหน่งในสตริงการค้นหาทั่วไป (เช่น pizza+seattle+wa)

ในตัวอย่างนี้ การค้นหาร้านพิซซ่าในซีแอตเทิล รัฐวอชิงตัน ได้แสดงผลลัพธ์ในแผนที่ต่อไปนี้

https://www.google.com/maps/search/?api=1&query=pizza+seattle+wa


เส้นทาง

การดําเนินการของเส้นทางจะแสดงเส้นทางระหว่างจุดที่ระบุ 2 จุดขึ้นไปบนแผนที่ รวมทั้งระยะทางและเวลาเดินทาง

การสร้าง URL เส้นทาง

https://www.google.com/maps/dir/?api=1&parameters

พารามิเตอร์

  • origin: กําหนดจุดเริ่มต้นในการแสดงผลเส้นทาง ค่าเริ่มต้นจะเป็นตําแหน่งเริ่มต้นที่เกี่ยวข้องมากที่สุด เช่น ตําแหน่งของผู้ใช้ (หากมี) หากไม่มี แผนที่ที่ได้อาจจะแสดงแบบฟอร์มเปล่าเพื่อให้ผู้ใช้ป้อนต้นทางได้ ค่าอาจเป็นชื่อสถานที่ ที่อยู่ หรือพิกัดละติจูด/ลองจิจูดที่คั่นด้วยคอมมา สตริงควรเข้ารหัส URL ดังนั้นควรแปลงที่อยู่อย่างเช่น "City Hall, New York, NY" เป็น City+Hall%2C+New+York%2C+NY

    หมายเหตุ: พารามิเตอร์นี้จะระบุหรือไม่ก็ได้ เว้นแต่คุณจะระบุ origin_place_id ใน URL หากคุณเลือกที่จะระบุ origin_place_id คุณต้องระบุ origin ใน URL ด้วย

  • origin_place_id (ไม่บังคับ): รหัสสถานที่คือตัวระบุที่เป็นข้อความซึ่งใช้ระบุสถานที่ได้โดยไม่ซ้ํากัน หากคุณกําลังพยายามระบุสถานประกอบการอย่างชัดเจน การใช้รหัสสถานที่เป็นการรับประกันที่ดีที่สุดว่าคุณจะลิงก์ไปยังสถานที่ที่ถูกต้อง URL ที่ใช้พารามิเตอร์นี้ต้องมี origin ด้วย
  • destination: กําหนดปลายทางของเส้นทาง หากไม่มี แผนที่ผลลัพธ์อาจให้แบบฟอร์มเปล่าเพื่อให้ผู้ใช้ป้อนปลายทางได้ ค่าอาจเป็นชื่อสถานที่ ที่อยู่ หรือพิกัดละติจูด/ลองจิจูดที่คั่นด้วยคอมมา สตริงควรเข้ารหัส URL ดังนั้นควรแปลงที่อยู่อย่างเช่น "City Hall, New York, NY" เป็น City+Hall%2C+New+York%2C+NY

    หมายเหตุ: พารามิเตอร์นี้จะระบุหรือไม่ก็ได้ เว้นแต่คุณจะระบุ destination_place_id ใน URL หากคุณเลือกที่จะระบุ destination_place_id คุณต้องระบุ destination ใน URL ด้วย

  • destination_place_id (ไม่บังคับ): รหัสสถานที่คือตัวระบุที่เป็นข้อความซึ่งใช้ระบุสถานที่ได้โดยไม่ซ้ํากัน หากคุณกําลังพยายามระบุสถานประกอบการอย่างชัดเจน การใช้รหัสสถานที่เป็นการรับประกันที่ดีที่สุดว่าคุณจะลิงก์ไปยังสถานที่ที่ถูกต้อง URL ที่ใช้พารามิเตอร์นี้ต้องมี destination ด้วย
  • travelmode (ไม่บังคับ): กําหนดวิธีการเดินทาง ตัวเลือกเป็น driving, walking (แนะนําให้มีทางเท้าและทางเท้า (หากมี)) bicycling (ตามเส้นทางจักรยานและถนนหลักว่าง) หรือ transit หากไม่มีการระบุ travelmode Google Maps จะแสดงโหมดที่เกี่ยวข้องมากที่สุดอย่างน้อย 1 โหมดสําหรับเส้นทางที่ระบุและ/หรือค่ากําหนดของผู้ใช้
  • dir_action=navigate (ไม่บังคับ): เปิดการนําทางแบบเลี้ยวต่อเลี้ยวหรือตัวอย่างเส้นทางไปยังปลายทางที่ระบุ โดยขึ้นอยู่กับว่าต้นทางนั้นพร้อมใช้งานหรือไม่ หากผู้ใช้ระบุต้นทางและไม่อยู่ใกล้กับตําแหน่งปัจจุบันของผู้ใช้ หรือตําแหน่งปัจจุบันของผู้ใช้ไม่พร้อมใช้งาน ตัวอย่างแผนที่จะเปิดขึ้น หากผู้ใช้ไม่ระบุต้นทาง (ในกรณีนี้ต้นทางจะมีค่าเริ่มต้นเป็น ตําแหน่งปัจจุบันของผู้ใช้) หรือต้นทางอยู่ใกล้กับตําแหน่งปัจจุบันของผู้ใช้ แผนที่จะเปิดตัวการนําทางแบบเลี้ยวต่อเลี้ยว โปรดทราบว่าการนําทางไม่พร้อมใช้งานในผลิตภัณฑ์ Google Maps บางรายการและ/หรือระหว่างปลายทางทั้งหมด ในกรณีดังกล่าว ระบบจะไม่สนใจพารามิเตอร์นี้
  • waypoints: ระบุสถานที่ตัวกลางอย่างน้อย 1 แห่งเพื่อกําหนดเส้นทางให้นําทางระหว่าง origin และ destination คุณระบุจุดอ้างอิงได้หลายจุดโดยใช้อักขระไปป์ (|) เพื่อแยกสถานที่ (เช่น Berlin,Germany|Paris,France) จํานวนจุดอ้างอิงที่อนุญาตจะแตกต่างกันไปตามแพลตฟอร์มที่ลิงก์เปิด โดยรองรับจุดอ้างอิงได้สูงสุด 3 จุดในเบราว์เซอร์บนอุปกรณ์เคลื่อนที่ และรองรับจุดอ้างอิงได้สูงสุด 9 จุด จุดที่แสดงบนแผนที่ตามลําดับเดียวกันกับที่แสดงใน URL จุดอ้างอิงแต่ละจุดอาจเป็นชื่อสถานที่ ที่อยู่ หรือพิกัดละติจูด/ลองจิจูดที่คั่นด้วยคอมมา สตริงควรเข้ารหัส URL ดังนั้นจุดอ้างอิง เช่น "เบอร์ลิน เยอรมนี|ปารีส ฝรั่งเศส" ควรแปลงเป็น Berlin%2CGermany%7CParis%2CFrance

    หมายเหตุ

    • ผลิตภัณฑ์บางรายการบน Google Maps ไม่รองรับการระบุจุดอ้างอิง ในกรณีดังกล่าว ระบบจะไม่สนใจพารามิเตอร์นี้
    • พารามิเตอร์นี้เป็นแบบไม่บังคับ เว้นแต่คุณจะระบุ waypoint_place_ids ใน URL หากคุณเลือกที่จะระบุ waypoint_place_ids คุณต้องระบุ waypoints ใน URL ด้วย
  • waypoint_place_ids (ไม่บังคับ): รหัสสถานที่คือตัวระบุที่เป็นข้อความซึ่งใช้ระบุสถานที่ได้โดยไม่ซ้ํากัน Waypoint_place_ids ช่วยให้คุณระบุรายการรหัสสถานที่ได้ตรงกับรายการ waypoints รหัสสถานที่ควรแสดงตามลําดับเดียวกับจุดอ้างอิง และคั่นด้วยอักขระไปป์ "|" (มีการเข้ารหัส URL เป็น %7C) หากคุณระบุสถานที่เฉพาะอย่างชัดเจน รหัสสถานที่คือการรับประกันที่ดีที่สุดว่าคุณจะลิงก์กับสถานที่ที่ถูกต้อง URL ที่ใช้พารามิเตอร์นี้จะต้องมี waypoints ด้วย

ตัวอย่างเส้นทาง

URL ต่อไปนี้จะเปิดแผนที่ในโหมดเส้นทางและมีแบบฟอร์มที่ให้ผู้ใช้ป้อนต้นทางและปลายทาง

https://www.google.com/maps/dir/?api=1

ตัวอย่างต่อไปนี้แสดงแผนที่ที่มีเส้นทางจักรยานจาก Space Needle ไปยังตลาด Pike Place ในซีแอตเทิล รัฐวอชิงตัน

https://www.google.com/maps/dir/?api=1&origin=Space+Needle+Seattle+WA&destination=Pike+Place+Market+Seattle+WA&travelmode=bicycling

ตัวอย่างต่อไปนี้เปิดตัวแผนที่พร้อมเส้นทางเดินเท้าจาก Google ในซิดนีย์ ออสเตรเลีย และอาคาร Queen Victoria

https://www.google.com/maps/dir/?api=1&origin=Google+Pyrmont+NSW&destination=QVB&destination_place_id=ChIJISz8NjyuEmsRFTQ9Iw7Ear8&travelmode=walking


การแสดงแผนที่

การทํางานในแผนที่จะแสดงแผนที่ที่ไม่มีเครื่องหมายหรือทิศทาง

การสร้าง URL ของแผนที่

https://www.google.com/maps/@?api=1&map_action=map&parameters

พารามิเตอร์

  • map_action=map (ต้องระบุ): ระบุประเภทของมุมมองแผนที่ที่จะแสดง Maps และ Street View ใช้ปลายทางเดียวกัน ต้องใส่ map_action เป็น map เพื่อให้แสดงแผนที่ได้
  • center (ไม่บังคับ): กําหนดกึ่งกลางของหน้าต่างแผนที่และยอมรับพิกัดละติจูด/ลองจิจูดเป็นค่าที่คั่นด้วยคอมมา (เช่น -33.8569,151.2152)
  • zoom (ไม่บังคับ): ตั้งค่าระดับการซูมเริ่มต้นของแผนที่ ค่าที่ยอมรับคือจํานวนเต็มตั้งแต่ 0 (ทั้งโลก) ถึง 21 (แต่ละอาคาร) ขีดจํากัดสูงสุดอาจแตกต่างกันไปขึ้นอยู่กับข้อมูลแผนที่ที่มีอยู่ในตําแหน่งที่เลือก ค่าเริ่มต้นคือ 15
  • basemap (ไม่บังคับ): กําหนดประเภทของแผนที่ที่จะแสดง ค่าอาจเป็น roadmap (ค่าเริ่มต้น), satellite หรือ terrain
  • layer (ไม่บังคับ): กําหนดเลเยอร์เพิ่มเติมเพื่อแสดงในแผนที่ (หากมี) ค่าอาจมีค่าใดค่าหนึ่งต่อไปนี้ ได้แก่ none (ค่าเริ่มต้น), transit, traffic หรือ bicycling

ตัวอย่างแผนที่

URL ตัวอย่างนี้จะเปิด Google Maps เริ่มต้นโดยมีจุดศูนย์กลางอยู่ที่ตําแหน่งปัจจุบันของผู้ใช้

https://www.google.com/maps/@?api=1&map_action=map

ตัวอย่างต่อไปนี้แสดงแผนที่ที่มีศูนย์กลางอยู่ที่ Katoomba, NSW, Australia (ที่ -33.712206,150.311941) และตั้งค่าพารามิเตอร์ zoom และ basemap ซึ่งไม่บังคับ

https://www.google.com/maps/@?api=1&map_action=map&center=-33.712206%2C150.311941&zoom=12&basemap=terrain


แสดงพาโนรามา Street View

การดําเนินการ "พาโนรามา" ช่วยให้คุณเรียกใช้มุมมองที่จะแสดงรูปภาพ Street View เป็นพาโนรามาแบบอินเทอร์แอกทีฟได้ พาโนรามาของ Street View แต่ละภาพจะแสดงมุมมอง 360 องศาที่สมบูรณ์จากสถานที่เดียว รูปภาพมีมุมมองแนวนอน 360 องศา (ภาพทั้งหมดรอบด้าน) และมุมมองแนวตั้ง 180 องศา (จากมุมมองตรงขึ้น-ลง) การดําเนินการ "พาโนรามา" จะเปิด โปรแกรมดูภาพที่แสดงผลพาโนรามาเป็นวงกลมโดยมีกล้องอยู่ตรงกลาง คุณปรับเปลี่ยนกล้องเพื่อควบคุมการซูมและการวางแนวของกล้องได้

Google Street View แสดงมุมมองแบบพาโนรามาจากสถานที่ที่กําหนดทั่วทั้งพื้นที่ที่ครอบคลุม นอกจากนี้ยังมีภาพ 360 องศาที่ผู้ใช้มีส่วนร่วมและคอลเล็กชันพิเศษของ Street View

การสร้าง URL ของ Street View

https://www.google.com/maps/@?api=1&map_action=pano&parameters

พารามิเตอร์

  • map_action=pano (ต้องระบุ): ระบุประเภทของมุมมองที่จะแสดง Maps และ Street View ใช้ปลายทางเดียวกัน หากต้องการให้แสดงพาโนรามา คุณต้องระบุ action เป็น pano

ต้องมีพารามิเตอร์ของ URL แบบใดแบบหนึ่งต่อไปนี้ด้วย

  • viewpoint: ผู้ชมแสดงพาโนรามาที่ถ่ายภาพใกล้กับตําแหน่ง viewpoint มากที่สุด ซึ่งระบุเป็นพิกัดละติจูด/ลองจิจูด (เช่น 46.414382,10.013988) เนื่องจาก Street View มีการรีเฟรชเป็นระยะๆ และบางครั้งระบบอาจถ่ายภาพจากมุมที่ต่างกันเล็กน้อย ตําแหน่งของคุณจึงอาจถ่ายพาโนรามาแบบพาโนรามาเมื่ออัปเดตภาพ
  • pano: รหัสพาโนรามาที่เจาะจงของรูปภาพที่จะแสดง หากระบุ pano ก็จะระบุ viewpoint ได้ด้วย ระบบจะใช้ viewpoint เฉพาะในกรณีที่ Google Maps ไม่พบรหัสพาโนรามา หากระบุ pano แล้ว แต่ไม่พบ viewpoint และ NOT อยู่ จะไม่มีการแสดงรูปภาพพาโนรามา แต่ Google Maps จะเปิดขึ้นในโหมดเริ่มต้นซึ่งแสดงแผนที่โดยมีจุดศูนย์กลางอยู่ที่ตําแหน่งปัจจุบันของผู้ใช้

พารามิเตอร์ของ URL ต่อไปนี้เป็นตัวเลือกที่ไม่บังคับ

  • heading: ระบุทิศทางเข็มทิศของกล้องถ่ายรูปให้เป็นองศาตามเข็มนาฬิกาจากทิศเหนือ ค่าที่ยอมรับคือตั้งแต่ -180 ถึง 360 องศา หากละเว้น ระบบจะเลือกส่วนหัวเริ่มต้นตามมุมมอง (หากระบุ) ของคําค้นหาและตําแหน่งจริงของรูปภาพ
  • pitch: ระบุมุมกล้องขึ้นหรือลง ค่าระดับเสียงที่กําหนดเป็นองศาตั้งแต่ -90 ถึง 90 ค่าบวกจะทําให้มุมของกล้องถ่ายรูปสูงขึ้น ส่วนค่าลบจะทําให้มุมของกล้องถ่ายรูปต่ําลง ระดับเสียงเริ่มต้นเป็น 0 จะได้รับการตั้งค่าตามตําแหน่งของกล้องเมื่อถ่ายภาพ ด้วยเหตุนี้ ระดับความสูงต่ําของ 0 จึงมักเป็นแนวนอน เช่น รูปภาพที่ถ่ายบนเนินเขามักแสดงระดับความสูงต่ําเริ่มต้นซึ่งไม่อยู่ในแนวนอน
  • fov: กําหนดขอบเขตการมองเห็นรูปภาพ ขอบเขตการมองเห็นจะแสดงเป็นองศาตั้งแต่ 10 - 100 ค่าเริ่มต้นคือ 90 เมื่อจัดการกับวิวพอร์ตขนาดคงที่ ช่องของมุมมองจะถือว่าเป็นระดับการซูม ส่วนตัวเลขที่เล็กกว่าหมายถึงการซูมในระดับที่สูงขึ้น

ตัวอย่าง Street View

ตัวอย่าง 2 ภาพแรกแสดงพาโนรามาของหอไอเฟล ตัวอย่างที่ 1 ใช้เพียง viewpoint สําหรับตําแหน่ง และตั้งค่าพารามิเตอร์ heading, pitch และ fov ซึ่งไม่บังคับ ในการเปรียบเทียบ ตัวอย่าง 2 ใช้รหัส pano เช่นเดียวกับพารามิเตอร์เดียวกันที่กําหนดไว้ในตัวอย่างแรก ตัวอย่างที่ 3 แสดงภาพพาโนรามาในร่ม

ตัวอย่างที่ 1: ใช้เฉพาะ viewpoint เพื่อระบุตําแหน่ง

https://www.google.com/maps/@?api=1&map_action=pano&viewpoint=48.857832%2C2.295226&heading=-45&pitch=38&fov=80

ตัวอย่างที่ 2: ใช้รหัส pano รวมถึงสถานที่ตั้ง viewpoint รหัส pano มีความสําคัญเหนือรหัส viewpoint ในตัวอย่างนี้ พบรหัสพาโนรามา จึงไม่สนใจ viewpoint โปรดสังเกตว่ารูปภาพพาโนรามาที่แสดงสําหรับรหัส pano จะแตกต่างกันเล็กน้อย และใหม่กว่ารูปภาพที่พบโดยใช้ viewpoint เท่านั้น

https://www.google.com/maps/@?api=1&map_action=pano&pano=tu510ie_z4ptBZYo2BGEJg&viewpoint=48.857832%2C2.295226&heading=-45&pitch=38&fov=80

ตัวอย่างที่ 3: แสดงพาโนรามาของร้านอาหาร Sarastro ในลอนดอน สหราชอาณาจักร โดยระบุรหัสพาโนรามา

https://www.google.com/maps/@?api=1&map_action=pano&pano=4U-oRQCNsC6u7r8gp02sLA

การค้นหารหัสพาโนรามา

การค้นหารหัสของรูปภาพพาโนรามาที่เฉพาะเจาะจงทําได้หลายวิธี

ตัวอย่างเพิ่มเติม

ตัวอย่างเส้นทางที่ใช้จุดอ้างอิง

ตัวอย่างเส้นทางต่อไปนี้เปิดตัว Google Maps และแสดงเส้นทางการขับขี่จากปารีส ฝรั่งเศส ไปยัง Cherbourg ฝรั่งเศส กําหนดเส้นทางผ่านจุดอ้างอิงต่อไปนี้

จังหวัด ประเทศชื่อสถานที่รหัสสถานที่
1. แวร์ซาย ฝรั่งเศส พระราชวังแวร์ซาย ChIJdUyx15R95kcRj85ZX8H8OAU
2. ชาร์แตร์ ฝรั่งเศส อาสนวิหาร Chartres Cathedral ChIJKzGHdEgM5EcR_OBTT3nQoEA
3. เลอมองส์ ฝรั่งเศส อาสนวิหาร Saint Julian of Le Mans ChIJG2LvQNCI4kcRKXNoAsPi1Mc
4. เคน ฝรั่งเศส ปราสาท Caen Castle ChIJ06tnGbxCCkgRsfNjEQMwUsc

ใน URL ตัวอย่าง ระบบกําหนดจุดอ้างอิงด้วยวิธีที่ต่างกันเพื่อให้คุณเปรียบเทียบความแตกต่างในการแสดงจุดอ้างอิงในแผนที่ที่ได้

ตัวอย่างที่ 1: จุดบนเส้นทางที่กําหนดเป็นเมือง ประเทศ:

https://www.google.com/maps/dir/?api=1&origin=Paris%2CFrance&destination=Cherbourg%2CFrance&travelmode=driving&waypoints=Versailles%2CFrance%7CChartres%2CFrance%7CLe+Mans%2CFrance%7CCaen%2CFrance

ตัวอย่างที่ 2: จุดบนเส้นทางที่กําหนดให้เป็นชื่อสถานที่ที่เฉพาะเจาะจง:

https://www.google.com/maps/dir/?api=1&origin=Paris%2CFrance&destination=Cherbourg%2CFrance&travelmode=driving&waypoints=Palace+of+Versailles%7CChartres+Cathedral%7CCathedral+of+Saint+Julian+of+Le+Mans%7CCaen+Castle

ตัวอย่างที่ 3: จุดอ้างอิงที่เป็นเมือง ประเทศ และยังมี waypoint_place_ids สําหรับสถานประกอบการแต่ละแห่งในแต่ละจุด

https://www.google.com/maps/dir/?api=1&origin=Paris%2CFrance&destination=Cherbourg%2CFrance&travelmode=driving&waypoints=Versailles%2CFrance%7CChartres%2CFrance%7CLe+Mans%2CFrance%7CCaen%2CFrance&waypoint_place_ids=ChIJdUyx15R95kcRj85ZX8H8OAU%7CChIJKzGHdEgM5EcR_OBTT3nQoEA%7CChIJG2LvQNCI4kcRKXNoAsPi1Mc%7CChIJ06tnGbxCCkgRsfNjEQMwUsc

ตัวอย่างที่ 4: กําหนดจุดอ้างอิงเป็นเมือง ประเทศ แต่แสดงจุดอ้างอิงในลําดับที่ต่างกันเมื่อเทียบกับตัวอย่างก่อนหน้า แสดงให้เห็นว่าแผนที่แสดงจุดอ้างอิงตามลําดับที่ระบุไว้ใน URL

https://www.google.com/maps/dir/?api=1&origin=Paris%2CFrance&destination=Cherbourg%2CFrance&travelmode=driving&waypoints=Versailles%2CFrance%7CCaen%2CFrance%7CLe+Mans%2CFrance%7CChartres%2CFrance

ตัวอย่างแผนที่

แสดงแผนที่ที่มี basemap (ดาวเทียม) และ layer (ขนส่งสาธารณะ) ที่ระบุ

https://www.google.com/maps/@?api=1&map_action=map&center=37.7992940%2C-122.3976113&zoom=15&basemap=satellite&layer=transit

ตัวอย่าง Street View

แสดงพาโนรามา Street View โดยใช้แป้นรูปภาพ FIFE เป็นรหัส pano โปรดทราบว่ารหัส pano จะขึ้นต้นด้วย F:

https://www.google.com/maps/@?api=1&map_action=pano&pano=F:-ud6AZSB-sQg/V0cfCSV3OWI/AAAAAAAAG1U/UQEoc5sXPQEIP7zzD6SWzmKb8Vbug47uQCLIB&heading=22&pitch=-5&fov=55