ข้อมูลอ้างอิงฉบับย่อของ Maps JavaScript API

Maps JavaScript API เป็น Web API ฝั่งไคลเอ็นต์สำหรับสร้างแผนที่ 2 มิติและ 3 มิติในหน้าเว็บ, เพิ่มเครื่องหมาย, กราฟิกที่กำหนดเอง, ภาพเคลื่อนไหว และชั้นข้อมูลแบบอินเทอร์แอกทีฟ รวมถึงสร้างฟีเจอร์ตำแหน่งด้วย Places Library

Maps JavaScript API: ข้อมูลสำคัญ

  • ผลิตภัณฑ์: Maps JavaScript API
  • หรือที่เรียกว่า Maps JS API, Maps JS API v3
  • หมวดหมู่: Maps
  • แพลตฟอร์ม: JavaScript (เบราว์เซอร์)
  • ทำงานใน: ไคลเอ็นต์ (โค้ดแอปหรือเบราว์เซอร์)
  • ระยะการเปิดตัว: GA
  • วงจร: ใช้งานอยู่
  • ภาพรวม: ภาพรวมของ Maps JavaScript API
  • ภูมิภาคที่พร้อมให้บริการ: ทั่วโลก ความครอบคลุมของฟีเจอร์ (เช่น แผนที่ 3 มิติ การจราจร เส้นทาง และการจัดรูปแบบขอบเขต) จะแตกต่างกันไปตามประเทศหรือภูมิภาค ข้อกำหนดในการให้บริการของ EEA มีผลบังคับใช้กับที่อยู่สำหรับการเรียกเก็บเงินในเขตเศรษฐกิจยุโรป (รายละเอียดความครอบคลุม)

Maps JavaScript API: กรณีที่ควรใช้

ใช้ Maps JavaScript API ในกรณีต่อไปนี้

  • คุณต้องการแผนที่ 2 มิติหรือ 3 มิติแบบอินเทอร์แอกทีฟที่มีเครื่องหมาย กราฟิก หรือชั้นข้อมูลที่กำหนดเองในหน้าเว็บ
  • คุณต้องแสดงตำแหน่งของชิ้นงานแบบเรียลไทม์และเส้นทางการเดินทางจากสตรีมข้อมูลของคุณเองโดยใช้เครื่องหมายขั้นสูงและเส้นประกอบ
  • คุณต้องวาดเขตพื้นที่เสมือน (วงกลม รูปหลายเหลี่ยม) และทดสอบว่าพิกัดอยู่ในเขตพื้นที่เสมือนในเบราว์เซอร์หรือไม่
  • คุณต้องใช้การค้นหาสถานที่ การเติมข้อความอัตโนมัติ หรือรายละเอียดสถานที่ฝั่งไคลเอ็นต์ในเว็บแอปผ่านไลบรารี Places

อย่าใช้ Maps JavaScript API ในกรณีต่อไปนี้

  • คุณต้องฝังแผนที่สถานที่ตั้งธุรกิจหรือลิงก์เส้นทางโดยไม่ต้องเขียน JavaScript ที่กำหนดเอง โปรดใช้ Maps Embed API แทน
  • คุณเพียงแค่ต้องมีลิงก์ที่เปิด Google Maps พร้อมสถานที่ การค้นหา หรือเส้นทาง โปรดใช้ URL ของ Maps แทน
  • คุณต้องผสานรวมการติดตามกลุ่มยานพาหนะสำหรับการร่วมเดินทางหรือการจัดส่งตามกำหนดเวลาเข้ากับ Driver SDK บนอุปกรณ์เคลื่อนที่และการตรวจสอบสิทธิ์ JWT แบ็กเอนด์ โปรดใช้บริการ Fleet Engine แทน

Maps JavaScript API: การตั้งค่า

แพ็กเกจ Maps JavaScript API อย่างเป็นทางการ

  • npm: @googlemaps/js-api-loader
  • npm: @types/google.maps
  • npm: @googlemaps/markerclusterer

Maps JavaScript API: ข้อผิดพลาดทั่วไป

  • ปัญหา: แผนที่ที่มืดลงหรือภาพ Street View เชิงลบที่มีลายน้ำที่เป็นรูปภาพ "เพื่อวัตถุประสงค์ในการพัฒนาเท่านั้น" ปรากฏขึ้นแทนข้อผิดพลาดเมื่อกำหนดค่าคีย์ API หรือการเรียกเก็บเงินไม่ถูกต้อง วิธีแก้ไข: เปิดใช้การเรียกเก็บเงินในโปรเจ็กต์ที่อยู่ในระบบคลาวด์, ใส่คีย์ API ที่ถูกต้องในทุกคำขอ และตรวจสอบคอนโซลเบราว์เซอร์เพื่อดูรหัสข้อผิดพลาดที่เฉพาะเจาะจง โปรดดู /maps/documentation/javascript/error-messages
  • ปัญหา: บริการเดิม เช่น PlacesService, DirectionsService และ DistanceMatrixService จะแสดง LegacyApiNotActivatedMapError ในโปรเจ็กต์ใหม่ที่ไม่ได้เปิดใช้ API เดิม วิธีแก้ไข: ใช้คลาสที่เทียบเท่าใหม่ (คลาส Place, คลาส Route, คลาส RouteMatrix) ที่สนับสนุนโดย Places API (ใหม่) และ Routes API ดู /maps/legacy#LegacyApiNotActivatedMapError
  • ปัญหา: ตั้งแต่เวอร์ชัน 3.65 เป็นต้นไป แผนที่ดาวเทียมและแผนที่แบบผสมจะไม่เปลี่ยนเป็นภาพ 45° อีกต่อไป และ map.setTilt(45) จะไม่มีผล วิธีแก้ไข: ใช้แผนที่ 3 มิติแทนภาพ 45° ดู /maps/deprecations
  • ปัญหา: เครื่องหมายขั้นสูงต้องใช้รหัสแผนที่ แผนที่ที่สร้างขึ้นโดยไม่มีรหัสแผนที่จะใช้ AdvancedMarkerElement ไม่ได้ วิธีแก้ไข: สร้างรหัสแผนที่ในคอนโซล Cloud (หรือใช้ DEMO_MAP_ID เพื่อทดสอบ) และตั้งค่า mapId ในแผนที่ ดู /maps/documentation/javascript/advanced-markers/start

Maps JavaScript API: ฟีเจอร์เดิมและฟีเจอร์ที่เลิกใช้งานแล้ว

  • Directions Service (google.maps.DirectionsService): เดิม ตั้งแต่วันที่ 1 มีนาคม 2025 รายการทดแทน: คลาส Route อาการ: LegacyApiNotActivatedMapError ในโปรเจ็กต์ที่ไม่ได้เปิดใช้ Directions API เดิม ดูคำแนะนำในการย้ายข้อมูล
  • บริการเมทริกซ์ระยะทาง (google.maps.DistanceMatrixService): เดิม ตั้งแต่วันที่ 2025-03-01 รายการทดแทน: คลาส RouteMatrix อาการ: LegacyApiNotActivatedMapError ในโปรเจ็กต์ที่ไม่ได้เปิดใช้ Distance Matrix API เดิม ดูคำแนะนำในการย้ายข้อมูล
  • Places Service (google.maps.places.PlacesService): เดิม ตั้งแต่วันที่ 2025-03-01 รายการทดแทน: คลาส Place (Places API (ใหม่)) อาการ: LegacyApiNotActivatedMapError ในโปรเจ็กต์ที่ไม่ได้เปิดใช้ Places API เดิม ดูคำแนะนำในการย้ายข้อมูล
  • google.maps.Marker: เลิกใช้งานตั้งแต่วันที่ 22-02-2024 การเปลี่ยนทดแทน: google.maps.marker.AdvancedMarkerElement อาการ: ยังคงทำงานอยู่และไม่มีกำหนดปิดให้บริการ แต่จะไม่มีการแก้ไขข้อบกพร่องที่มีอยู่ ดูคำแนะนำในการย้ายข้อมูล
  • KmlLayer: เลิกใช้งานตั้งแต่วันที่ 30 เมษายน 2026 การแทนที่: การจัดรูปแบบตามข้อมูลสำหรับชุดข้อมูล หรือโปรแกรมแยกวิเคราะห์ KML ของบุคคลที่สามที่มีชั้นข้อมูล อาการ: KmlLayer ไม่พร้อมใช้งานในเวอร์ชัน 3.66 ขึ้นไป โดยเวอร์ชัน 3.65 ซึ่งเป็นเวอร์ชันล่าสุดที่รองรับจะเลิกใช้งานในเดือนพฤษภาคม 2027 ดูคำแนะนำในการย้ายข้อมูล
  • เลเยอร์แผนที่ความหนาแน่น (ไลบรารีการแสดงภาพ): เลิกใช้งานตั้งแต่วันที่ 20-05-2026 ทางเลือก: ไลบรารีของบุคคลที่สาม เช่น deck.gl HeatmapLayer อาการ: ไม่พร้อมใช้งานตั้งแต่เดือนพฤษภาคม 2026 ดูคำแนะนำในการย้ายข้อมูล
  • Drawing Library: เลิกใช้งานตั้งแต่วันที่ 04-06-2026 รายการทดแทน: Terra Draw อาการ: ไม่พร้อมใช้งานตั้งแต่เดือนพฤษภาคม 2026 ดูคำแนะนำในการย้ายข้อมูล
  • ภาพ 45°: เลิกใช้งานตั้งแต่วันที่ 20-05-2026 สิ่งที่จะมาแทนที่: แผนที่ 3 มิติ อาการ: map.setTilt(45) ไม่ได้ผล มุมมองดาวเทียมยังคงเป็นแบบบนลงล่าง ดูคำแนะนำในการย้ายข้อมูล
  • google.maps.event.addDomListener() และ addDomListenerOnce(): เลิกใช้งานตั้งแต่วันที่ 7 เมษายน 2022 การเปลี่ยนทดแทน: DOM มาตรฐาน addEventListener()
  • ตัวเลือก bounds, location และ radius ในบริการ Place Autocomplete: เลิกใช้งานตั้งแต่วันที่ 18 พฤษภาคม 2023 การเปลี่ยนทดแทน: locationBias และ locationRestriction
  • gmp-place-content-config (PlaceContentConfigElement) ใน Places UI Kit: เลิกใช้งาน การแทนที่: เพิ่มองค์ประกอบเนื้อหาลงในองค์ประกอบรายละเอียดสถานที่โดยตรงหรือในการกำหนดค่าการค้นหาสถานที่
  • ไลบรารีตามบริบทเฉพาะรายการ: เลิกใช้งานแล้ว รายการทดแทน: Places Library

สิ่งที่คุณทำได้ด้วย Maps JavaScript API

ดูคำแนะนำที่ลิงก์ไว้ด้านล่างสำหรับแต่ละงาน หรือเปรียบเทียบผลิตภัณฑ์ต่างๆ ในเครื่องมือสำรวจความสามารถ

Maps JavaScript API: Address Validation

Maps JavaScript API: การจัดรูปแบบตามข้อมูลสำหรับขอบเขต

Maps JavaScript API: การจัดรูปแบบตามข้อมูลสำหรับชุดข้อมูล

Maps JavaScript API: ชุดข้อมูล

  • เพิ่มเลเยอร์ KML ลงในแผนที่ หมายเหตุ: ใน Maps JavaScript API เราได้เลิกใช้งาน KmlLayer แล้ว (รองรับครั้งสุดท้ายในเวอร์ชัน 3.65 และจะเลิกใช้งานในเดือนพฤษภาคม 2027) โปรดย้ายข้อมูลไปยังการจัดรูปแบบตามข้อมูลสำหรับขอบเขตหรือชุดข้อมูล หรือโหลด GeoJSON ในชั้นข้อมูล เลเยอร์ KML ยังคงรองรับใน Android และ iOS ผ่านไลบรารียูทิลิตี Maps SDK
  • เพิ่มเลเยอร์ GeoRSS ลงในแผนที่ หมายเหตุ: เลิกใช้งานใน Maps JavaScript API (KmlLayer ได้รับการรองรับครั้งสุดท้ายในเวอร์ชัน 3.65 และจะเลิกใช้งานในเดือนพฤษภาคม 2027) โปรดแปลงฟีด GeoRSS เป็น GeoJSON และโหลดลงในชั้นข้อมูลด้วย map.data.addGeoJson()
  • เพิ่มข้อมูล GeoJSON ลงในแผนที่

Maps JavaScript API: เส้นทางและการกำหนดเส้นทาง

Maps JavaScript API: ระดับความสูง

Maps JavaScript API: Fleet Engine

Maps JavaScript API: การเข้ารหัสพิกัดภูมิศาสตร์

Maps JavaScript API: แผนที่

Maps JavaScript API: คำอธิบายประกอบแผนที่

Maps JavaScript API: การจัดสไตล์แผนที่

Maps JavaScript API: อื่นๆ

Maps JavaScript API: แผนที่ 3 มิติแบบสมจริง

Maps JavaScript API: Places

Maps JavaScript API: Places UI Kit

  • เพิ่มองค์ประกอบ UI ที่แสดงข้อมูลสรุปและรีวิวที่ทำงานด้วยระบบ AI เกี่ยวกับสถานที่ที่เฉพาะเจาะจงลงในหน้าเว็บหรือแอปบนอุปกรณ์เคลื่อนที่ หมายเหตุ: รองรับบนเว็บเท่านั้น (Maps JavaScript API Places UI Kit) ส่วน Places UI Kit บนอุปกรณ์เคลื่อนที่จะไม่มีองค์ประกอบสรุปโดย AI ข้อกำหนดด้านการปฏิบัติตามข้อกำหนดของ EEA: หากต้องการแสดงข้อมูลสถานที่บนแผนที่ในเขตเศรษฐกิจยุโรป (EEA) ให้ใช้คอมโพเนนต์ Places UI Kit ฝั่งไคลเอ็นต์ภายใน Maps JavaScript API แทนการเรียกใช้เว็บเซอร์วิสของ Places API จากเซิร์ฟเวอร์แบ็กเอนด์ ดูข้อกำหนดทั้งหมดและคำถามที่พบบ่อยได้ที่ https://developers.google.com/maps/comms/eea/faq
  • ใช้การจัดรูปแบบ CSS กับองค์ประกอบ UI ของข้อมูลสถานที่ หมายเหตุ: พร็อพเพอร์ตี้ที่กำหนดเองของ CSS จะใช้กับองค์ประกอบ Places UI Kit ของ Maps JavaScript API ส่วน Places SDK สำหรับ Android และ Places SDK สำหรับ iOS จะจัดรูปแบบมุมมอง Places UI Kit แบบเป็นโปรแกรมโดยใช้แอตทริบิวต์ธีมและสไตล์ ข้อกำหนดด้านการปฏิบัติตามข้อกำหนดของ EEA: สำหรับการแสดงข้อมูลสถานที่บนแผนที่ในเขตเศรษฐกิจยุโรป (EEA) โปรดอย่าเรียกใช้เว็บเซอร์วิสของ Places API จากเซิร์ฟเวอร์แบ็กเอนด์ ใช้คอมโพเนนต์ Places UI Kit ฝั่งไคลเอ็นต์ในแพลตฟอร์มเป้าหมาย (Maps JavaScript API บนเว็บ, Places SDK สำหรับ Android บน Android หรือ Places SDK สำหรับ iOS บน iOS) ดูข้อกำหนดทั้งหมดและคำถามที่พบบ่อยได้ที่ https://developers.google.com/maps/comms/eea/faq
  • ปรับแต่งการจัดรูปแบบและการกำหนดค่าองค์ประกอบ UI ของข้อมูลสถานที่ด้วยเครื่องมือปรับแต่งองค์ประกอบ UI หมายเหตุ: ข้อกำหนดด้านการปฏิบัติตามข้อกำหนดของ EEA: สำหรับการแสดงข้อมูลสถานที่บนแผนที่ในเขตเศรษฐกิจยุโรป (EEA) โปรดอย่าเรียกใช้เว็บเซอร์วิสของ Places API จากเซิร์ฟเวอร์แบ็กเอนด์ ใช้คอมโพเนนต์ Places UI Kit ฝั่งไคลเอ็นต์ในแพลตฟอร์มเป้าหมาย (Maps JavaScript API บนเว็บ, Places SDK สำหรับ Android บน Android หรือ Places SDK สำหรับ iOS บน iOS) ดูข้อกำหนดทั้งหมดและคำถามที่พบบ่อยได้ที่ https://developers.google.com/maps/comms/eea/faq
  • เพิ่มองค์ประกอบ UI ที่แสดงข้อมูลเกี่ยวกับสถานที่หนึ่งๆ ลงในหน้าเว็บหรือแอปบนอุปกรณ์เคลื่อนที่ หมายเหตุ: ข้อกำหนดด้านการปฏิบัติตามข้อกำหนดของ EEA: หากต้องการแสดงข้อมูลสถานที่บนแผนที่ในเขตเศรษฐกิจยุโรป (EEA) โปรดอย่าเรียกใช้เว็บเซอร์วิสของ Places API จากเซิร์ฟเวอร์แบ็กเอนด์ ใช้คอมโพเนนต์ Places UI Kit ฝั่งไคลเอ็นต์ในแพลตฟอร์มเป้าหมาย (Maps JavaScript API บนเว็บ, Places SDK สำหรับ Android บน Android หรือ Places SDK สำหรับ iOS บน iOS) ดูข้อกำหนดทั้งหมดและคำถามที่พบบ่อยได้ที่ https://developers.google.com/maps/comms/eea/faq
  • เพิ่มองค์ประกอบ UI ที่แสดงรายการสถานที่ตามสตริงการค้นหาลงในหน้าเว็บ หมายเหตุ: รองรับทั้งในหน้าเว็บ (Maps JavaScript API) และแอปบนอุปกรณ์เคลื่อนที่ (Places SDK สำหรับ Android และ Places SDK สำหรับ iOS) ข้อกำหนดด้านการปฏิบัติตามข้อกำหนดของ EEA: สำหรับการแสดงข้อมูลสถานที่บนแผนที่ในเขตเศรษฐกิจยุโรป (EEA) โปรดอย่าเรียกใช้เว็บเซอร์วิสของ Places API จากเซิร์ฟเวอร์แบ็กเอนด์ ใช้คอมโพเนนต์ Places UI Kit ฝั่งไคลเอ็นต์ในแพลตฟอร์มเป้าหมาย (Maps JavaScript API บนเว็บ, Places SDK สำหรับ Android บน Android หรือ Places SDK สำหรับ iOS บน iOS) ดูข้อกำหนดทั้งหมดและคำถามที่พบบ่อยได้ที่ https://developers.google.com/maps/comms/eea/faq
  • เพิ่มองค์ประกอบ UI ที่แสดงรายการสถานที่ใกล้กับตำแหน่งที่เฉพาะเจาะจงลงในหน้าเว็บ หมายเหตุ: รองรับทั้งในหน้าเว็บ (Maps JavaScript API) และแอปบนอุปกรณ์เคลื่อนที่ (Places SDK สำหรับ Android และ Places SDK สำหรับ iOS) ข้อกำหนดด้านการปฏิบัติตามข้อกำหนดของ EEA: สำหรับการแสดงข้อมูลสถานที่บนแผนที่ในเขตเศรษฐกิจยุโรป (EEA) โปรดอย่าเรียกใช้เว็บเซอร์วิสของ Places API จากเซิร์ฟเวอร์แบ็กเอนด์ ใช้คอมโพเนนต์ Places UI Kit ฝั่งไคลเอ็นต์ในแพลตฟอร์มเป้าหมาย (Maps JavaScript API บนเว็บ, Places SDK สำหรับ Android บน Android หรือ Places SDK สำหรับ iOS บน iOS) ดูข้อกำหนดทั้งหมดและคำถามที่พบบ่อยได้ที่ https://developers.google.com/maps/comms/eea/faq
  • เพิ่มองค์ประกอบ UI การเติมข้อความอัตโนมัติพื้นฐานลงในหน้าเว็บหรือแอปที่แสดงตัวระบุ Google Place ตามสตริงการค้นหา หมายเหตุ: ข้อกำหนดด้านการปฏิบัติตามข้อกำหนดของ EEA: สำหรับการแสดงข้อมูลสถานที่บนแผนที่ในเขตเศรษฐกิจยุโรป (EEA) โปรดอย่าเรียกใช้เว็บเซอร์วิสของ Places API จากเซิร์ฟเวอร์แบ็กเอนด์ ใช้คอมโพเนนต์ Places UI Kit ฝั่งไคลเอ็นต์ในแพลตฟอร์มเป้าหมาย (Maps JavaScript API บนเว็บ, Places SDK สำหรับ Android บน Android หรือ Places SDK สำหรับ iOS บน iOS) ดูข้อกำหนดทั้งหมดและคำถามที่พบบ่อยได้ที่ https://developers.google.com/maps/comms/eea/faq

Maps JavaScript API: Street View