พารามิเตอร์ของ URL ของ Maps JavaScript API

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

URL ตัวอย่างต่อไปนี้มีตัวยึดตําแหน่งสําหรับพารามิเตอร์ที่เป็นไปได้ทั้งหมด

https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY
&callback=FUNCTION_NAME
&v=VERSION
&libraries="LIBRARIES"
&language="LANGUAGE"
&region="REGION"
&solution_channel="SOLUTION_IDENTIFIER"
&auth_referrer_policy="AUTH_REFERRER_POLICY"

URL ในแท็ก script ตัวอย่างต่อไปนี้โหลด Maps JavaScript API

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
</script>

พารามิเตอร์ที่จำเป็น

จําเป็นต้องมีพารามิเตอร์ต่อไปนี้เมื่อโหลด Maps JavaScript API

  • key: คีย์ API ของคุณ Maps API จะไม่โหลด เว้นแต่จะระบุคีย์ API ที่ถูกต้อง

  • callback: ชื่อของฟังก์ชันส่วนกลางที่จะเรียกเมื่อ Maps JavaScript API โหลดโดยสมบูรณ์

พารามิเตอร์ที่ไม่บังคับ

ใช้พารามิเตอร์เหล่านี้เพื่อขอ Maps JavaScript API เวอร์ชันที่ต้องการ โหลดไลบรารีเพิ่มเติม แปลแผนที่ หรือระบุนโยบายการตรวจสอบผู้อ้างอิง HTTP

  • v: เวอร์ชันของ Maps JavaScript API ที่จะใช้

  • libraries: รายการไลบรารีไลบรารีเพิ่มเติมของJavaScript API ที่คั่นด้วยคอมมา

  • language: ภาษาที่จะใช้ การดําเนินการนี้จะมีผลต่อชื่อการควบคุม ประกาศเกี่ยวกับลิขสิทธิ์ เส้นทางการขับขี่ และป้ายกํากับการควบคุม รวมถึงการตอบกลับคําขอบริการ ดูรายการภาษาที่รองรับ

  • region: รหัสภูมิภาคที่จะใช้ ซึ่งจะเปลี่ยนการทํางานของแผนที่ตามประเทศหรือเขตแดนที่ระบุ

  • solution_channel: Google Maps Platform มีโค้ดตัวอย่างหลายประเภท ที่จะช่วยให้คุณเริ่มต้นใช้งานได้อย่างรวดเร็ว หากต้องการติดตามการใช้ตัวอย่างโค้ดที่ซับซ้อนขึ้นและปรับปรุงคุณภาพโซลูชัน Google จะรวมพารามิเตอร์การค้นหา solution_channel ในการเรียก API ในโค้ดตัวอย่าง

  • auth_referrer_policy: ลูกค้า Maps JS สามารถกําหนดค่าข้อจํากัดผู้อ้างอิง HTTP ใน Cloud Console เพื่อจํากัด URL ที่อนุญาตให้ใช้คีย์ API ได้ โดยค่าเริ่มต้น คุณสามารถกําหนดค่าข้อจํากัดเหล่านี้เพื่ออนุญาตให้ใช้บางเส้นทางเพื่อใช้คีย์ API ได้เท่านั้น หาก URL ในโดเมนหรือต้นทางเดียวกันอาจใช้คีย์ API คุณจะตั้งค่า auth_referrer_policy=origin เพื่อจํากัดปริมาณข้อมูลที่ส่งเมื่อให้สิทธิ์คําขอจาก Maps JavaScript API ได้ มีให้บริการในเวอร์ชัน 3.46 เมื่อระบุพารามิเตอร์นี้และเปิดใช้ข้อจํากัดผู้อ้างอิง HTTP ใน Cloud Console แล้ว Maps JavaScript API จะโหลดได้เมื่อมีข้อจํากัดการอ้างอิง HTTP ที่ตรงกับโดเมนของเว็บไซต์ปัจจุบันโดยไม่มีเส้นทางที่ระบุ