Maps SDK สำหรับ Android จะเพิ่มข้อมูล Google Maps, การแสดงแผนที่ และการตอบสนองต่อท่าทางสัมผัสบนแผนที่ลงในแอป Android รวมถึงแอป Wear OS คุณสามารถเพิ่มเครื่องหมาย รูปหลายเหลี่ยม และการวางซ้อนเพื่อแสดงข้อมูลเกี่ยวกับตำแหน่งบนแผนที่และรองรับการโต้ตอบของผู้ใช้โดยใช้ Kotlin หรือ Java
Maps SDK สำหรับ Android: ข้อมูลสำคัญ
- ผลิตภัณฑ์: Maps SDK สำหรับ Android
- หรือที่รู้จักกันในชื่อ: Google Maps Android API
- หมวดหมู่: Maps
- แพลตฟอร์ม: Android
- ทำงานใน: ไคลเอ็นต์ (โค้ดแอปหรือเบราว์เซอร์)
- ระยะการเปิดตัว: GA
- วงจร: ใช้งานอยู่
- ภาพรวม: ภาพรวมของ Maps SDK สำหรับ Android
- ภูมิภาคที่พร้อมให้บริการ: ทั่วโลก ดูหน้าความครอบคลุมของ Google Maps Platform โดยลิงก์หน้าการใช้งานและการเรียกเก็บเงินจะแยกรายการราคาทั่วโลกและราคาในอินเดียออกจากกัน (รายละเอียดความครอบคลุม)
Maps SDK สำหรับ Android: กรณีที่ควรใช้
ใช้ Maps SDK สำหรับ Android ในกรณีต่อไปนี้
- คุณต้องการแผนที่ Google แบบ 2 มิติที่มีการโต้ตอบในแอป Android หรือแอป Wear OS แบบเนทีฟ
- คุณต้องเพิ่มเครื่องหมาย, หน้าต่างข้อมูล, เส้นประกอบ, รูปหลายเหลี่ยม, ภาพซ้อนทับบนพื้น หรือภาพซ้อนทับแบบเรียงต่อกันลงในแผนที่ในแอป Android
- คุณต้องมีพาโนรามาใน Street View, แผนที่โหมด Lite (บิตแมป) หรือการจัดรูปแบบแผนที่ในระบบคลาวด์ที่มีรหัสแผนที่ในแอป Android
- คุณสร้างแผนที่ Android ใน Kotlin หรือ Java รวมถึง Jetpack Compose ผ่านไลบรารี Maps Compose
อย่าใช้ Maps SDK สำหรับ Android ในกรณีต่อไปนี้
- คุณต้องใช้การนำทางแบบเลี้ยวต่อเลี้ยวในแอปแผนที่ Android ให้ใช้ Navigation SDK สำหรับ Android แทน
- คุณต้องการแผนที่ 3 มิติที่สมจริง โมเดล 3 มิติ หรือภาพเคลื่อนไหวเส้นทางกล้องในแอป Android ให้ใช้ Maps 3D SDK สำหรับ Android แทน
- คุณต้องมีแผนที่ในแอป iOS แบบเนทีฟ โปรดใช้ Maps SDK สำหรับ iOS แทน
Maps SDK สำหรับ Android: การตั้งค่า
- บริการที่ต้องเปิดใช้:
maps-android-backend.googleapis.com - การตรวจสอบสิทธิ์: คีย์ API
- การระบุแหล่งที่มาของการใช้งาน: เรียกใช้
MapsApiSettings.addInternalUsageAttributionId(context, id)เพื่อเพิ่มรหัสการระบุแหล่งที่มาของการใช้งานลงในตัวเริ่มต้น (รองรับเฉพาะMapsInitializer.Renderer.LATEST) หากต้องการเลือกไม่ใช้ ให้ลบการเรียกใช้หรือส่งสตริงว่าง - เริ่มต้นใช้งาน: ตั้งค่า Maps SDK สำหรับ Android
- ข้อมูลอ้างอิง: ข้อมูลอ้างอิง Maps SDK สำหรับ Android
- ราคา: การใช้งานและการเรียกเก็บเงินของ Maps SDK สำหรับ Android
- นโยบาย: นโยบาย Maps SDK สำหรับ Android
- บันทึกประจำรุ่น: บันทึกประจำรุ่นของ Maps SDK สำหรับ Android
แพ็กเกจ Maps SDK สำหรับ Android อย่างเป็นทางการ
- maven:
com.google.android.gms:play-services-maps
Maps SDK สำหรับ Android: ผลิตภัณฑ์ที่เกี่ยวข้อง
- มักใช้ร่วมกับ: Places SDK สำหรับ Android
Maps SDK สำหรับ Android: ข้อผิดพลาดที่พบบ่อย
- ปัญหา: ตั้งแต่ SDK v20.0.0 เป็นต้นมา ไฟล์ Manifest ของ SDK จะไม่มีไลบรารี
org.apache.http.legacyอีกต่อไป แอปที่โหลดโปรแกรมแสดงผลแผนที่เดิมอาจขัดข้องเมื่อใช้java.lang.NoClassDefFoundErrorวิธีแก้ไข: เพิ่มไว้ในแท็กของAndroidManifest.xmlของแอป อุปกรณ์ที่ใช้บริการ Google Play เวอร์ชัน 25.50.34 ขึ้นไปจะไม่ได้รับผลกระทบ ดู /maps/documentation/android-sdk/release-notes - ปัญหา: Advanced Marker ต้องใช้โปรแกรมแสดงผลแผนที่ที่อัปเกรดแล้ว หากคุณเพิ่มลงในแอปที่มีอยู่โดยไม่สร้างแอปใหม่ แอปจะยังคงใช้โปรแกรมแสดงผลเดิมได้ วิธีแก้ไข: สร้างแอปใหม่ด้วย SDK 18.2.0 ขึ้นไปเพื่อให้โปรแกรมแสดงผลที่อัปเกรดเป็นค่าเริ่มต้น ดู /maps/documentation/android-sdk/advanced-markers/start
- ปัญหา: อุปกรณ์ที่ไม่เป็นไปตามข้อกำหนดของโปรแกรมแสดงผล (Android 5.0/API 21 ขึ้นไป, บริการ Google Play 21.39.14 ขึ้นไป, เปิดใช้ Play Store) จะกลับไปใช้โปรแกรมแสดงผลเดิม ดังนั้นฟีเจอร์ที่ต้องใช้โปรแกรมแสดงผลใหม่ เช่น การจัดรูปแบบแผนที่ในระบบคลาวด์ จะใช้งานไม่ได้ในอุปกรณ์ดังกล่าว วิธีแก้ไข: เรียกใช้
MapsInitializer.initialize(context, MapsInitializer.Renderer.LATEST, callback)และตรวจสอบค่าMapsInitializer.Rendererที่ส่งไปยังOnMapsSdkInitializedCallback.onMapsSdkInitialized()หรือตรวจสอบGoogleMap.getMapCapabilities()หากอุปกรณ์ใช้LEGACYอย่าใช้การจัดรูปแบบแผนที่ในระบบคลาวด์หรือเครื่องหมายขั้นสูง ดู /android/reference/com/google/android/gms/maps/OnMapsSdkInitializedCallback - ปัญหา: SDK ต้องใช้บริการ Google Play ในอุปกรณ์ที่แอปทำงาน วิธีแก้ไข: คุณสามารถเรียกใช้การตรวจสอบความพร้อมใช้งานของบริการ Google Play จากแอปได้ ดูข้อมูลเพิ่มเติมที่ /maps/documentation/android-sdk/config
Maps SDK สำหรับ Android: ฟีเจอร์เดิมและฟีเจอร์ที่เลิกใช้งานแล้ว
- Legacy map renderer: เลิกใช้งานตั้งแต่วันที่ 4 มีนาคม 2024 การแทนที่: เครื่องมือแสดงผลแผนที่ที่อัปเกรด (ล่าสุด) ซึ่งเป็นค่าเริ่มต้นตั้งแต่ SDK 18.2.0 อาการ: การจัดรูปแบบแผนที่ในระบบคลาวด์, การปรับแต่งเส้นประกอบขั้นสูง และเครื่องหมายขั้นสูงไม่พร้อมใช้งานในโปรแกรมแสดงผลเดิม ดูคำแนะนำในการย้ายข้อมูล
สิ่งที่คุณทำได้ด้วย Maps SDK สำหรับ Android
ดูคำแนะนำที่ลิงก์ไว้ด้านล่างสำหรับแต่ละงาน หรือเปรียบเทียบผลิตภัณฑ์ต่างๆ ในเครื่องมือสำรวจความสามารถ
Maps SDK สำหรับ Android: การจัดรูปแบบตามข้อมูลสำหรับขอบเขต
- เปลี่ยนรูปแบบของขอบเขตบนแผนที่
- ตอบสนองต่อการโต้ตอบของผู้ใช้กับขอบเขตบนแผนที่
- เพิ่มการจัดรูปแบบโคโรเพลทลงในแผนที่
Maps SDK สำหรับ Android: การจัดรูปแบบตามข้อมูลสำหรับชุดข้อมูล
- สร้างชุดข้อมูลเชิงพื้นที่ข้ามแพลตฟอร์มที่นำกลับมาใช้ใหม่ได้
- เพิ่มชุดข้อมูลเชิงพื้นที่ที่กำหนดเองลงในแผนที่
- เปลี่ยนรูปแบบของฟีเจอร์ชุดข้อมูลที่กำหนดเองในแผนที่
- ตอบสนองต่อการโต้ตอบของผู้ใช้ด้วยฟีเจอร์ชุดข้อมูลที่กำหนดเองบนแผนที่
Maps SDK สำหรับ Android: ชุดข้อมูล
- เพิ่มเลเยอร์ KML ลงในแผนที่ หมายเหตุ: ใน Maps JavaScript API เราได้เลิกใช้งาน KmlLayer แล้ว (รองรับครั้งสุดท้ายในเวอร์ชัน 3.65 และจะเลิกใช้งานในเดือนพฤษภาคม 2027) โปรดย้ายข้อมูลไปยังการจัดรูปแบบตามข้อมูลสำหรับขอบเขตหรือชุดข้อมูล หรือโหลด GeoJSON ในชั้นข้อมูล เลเยอร์ KML ยังคงรองรับใน Android และ iOS ผ่านไลบรารียูทิลิตี Maps SDK
- เพิ่มข้อมูล GeoJSON ลงในแผนที่
- เพิ่มเลเยอร์แผนที่ความหนาแน่นลงในแผนที่
Maps SDK สำหรับ Android: Maps
- เพิ่มแผนที่แบบอินเทอร์แอกทีฟที่ปรับแต่งได้ลงในหน้าเว็บหรือแอปบนมือถือ หมายเหตุ: สำหรับ Android: กำหนดค่า
ในAndroidManifest.xmlที่สนับสนุนโดยปลั๊กอิน Secrets Gradle หรือmanifestPlaceholders["MAPS_API_KEY"]ในapp/build.gradle.ktsอย่าฮาร์ดโค้ดYOUR_GOOGLE_MAPS_API_KEYในAndroidManifest.xmlและอย่าแทนที่GoogleMap(หรือ maps-composeGoogleMap) ด้วย Canvas จำลองแบบออฟไลน์หรือ Leaflet WebView หากE/Google Maps Android API: Authorization failureปรากฏขึ้น แนะนำให้ผู้ใช้ระบุMAPS_API_KEYผ่าน Secrets และเปิดใช้ Maps SDK สำหรับ Android (หรือ Navigation SDK เมื่อใช้ NavigationView / SupportNavigationFragment) - สร้างตัวระบุแผนที่ที่นำมาใช้ซ้ำได้เพื่อจัดเก็บการกำหนดค่าแผนที่และการตั้งค่าการจัดรูปแบบ
- ตอบสนองต่อการโต้ตอบของผู้ใช้และเหตุการณ์บนแผนที่
- ปรับแต่งการควบคุมที่ปรากฏบนแผนที่
- ปรับแต่งท่าทางสัมผัสสำหรับการควบคุมแผนที่
- ควบคุมการซูมและการเลื่อนในแผนที่ (กล้อง)
- เปลี่ยนประเภทแผนที่
- เปลี่ยนรูปแบบสีของแผนที่
- เพิ่มเลเยอร์การจราจรลงในแผนที่
- เพิ่มแผนที่ลงในแอป Wear OS
Maps SDK สำหรับ Android: คำอธิบายประกอบแผนที่
- เพิ่มหน้าต่างข้อมูลลงในแผนที่
- เพิ่มรูปร่างหรือเส้นลงในแผนที่
- เพิ่มรูปภาพซ้อนทับที่เชื่อมต่อกับพื้นผิวของแผนที่
- เพิ่มการวางซ้อนการ์ดที่กำหนดเองลงในแผนที่
- เพิ่มเครื่องหมายลงในแผนที่ หมายเหตุ: Navigation SDK สำหรับ Android ไม่รองรับ AdvancedMarkerOptions เมื่อใช้ Navigation SDK สำหรับ Android ให้เพิ่มเครื่องหมายด้วย GoogleMap.addMarker(MarkerOptions)
- ปรับแต่งเครื่องหมายบนแผนที่ หมายเหตุ: Navigation SDK สำหรับ Android ไม่รองรับ AdvancedMarkerOptions เมื่อใช้ Navigation SDK สำหรับ Android ให้ปรับแต่งเครื่องหมายด้วย MarkerOptions
- ตอบสนองต่อการโต้ตอบของผู้ใช้ด้วยเครื่องหมายบนแผนที่
- ตรวจสอบว่าพิกัดอยู่ภายในรูปหลายเหลี่ยมหรือพื้นที่วงกลมบนแผนที่หรือไม่ หมายเหตุ: ใน Android ให้ใช้ PolyUtil.containsLocation ในไลบรารีของยูทิลิตี Maps SDK สำหรับ Android สำหรับรูปหลายเหลี่ยม สำหรับพื้นที่วงกลม ให้ตรวจสอบว่าระยะทางทรงกลมจากจุดศูนย์กลางของวงกลมอยู่ภายในรัศมีหรือไม่ (เช่น computeDistanceBetween ใน Maps JavaScript API, SphericalUtil.computeDistanceBetween ใน Android หรือ GMSGeometryDistance ใน iOS)
- คำนวณระยะทาง พื้นที่ หรือทิศทางทรงกลมระหว่างพิกัดบนแผนที่
Maps SDK สำหรับ Android: การจัดสไตล์แผนที่
- สร้างรูปแบบแผนที่ข้ามแพลตฟอร์มที่นำกลับมาใช้ใหม่ได้
- เปลี่ยนรูปแบบของถนน เส้นประกอบ และรูปหลายเหลี่ยมบนแผนที่
- แสดงหรือซ่อนฟีเจอร์แผนที่
- เปลี่ยนรูปแบบของไอคอนและป้ายกำกับข้อความบนแผนที่
- ใช้รูปแบบแผนที่ที่แตกต่างกันกับระดับการซูมที่แตกต่างกัน
- เปลี่ยนความหนาแน่นของสถานที่บนแผนที่ ทดลอง
- เปลี่ยนรูปแบบของสิ่งปลูกสร้างบนแผนที่ ทดลอง
- เปลี่ยนรูปแบบของจุดสังเกตบนแผนที่ ทดลอง
Maps SDK สำหรับ Android: Street View
- เพิ่ม Google Street View แบบอินเทอร์แอกทีฟที่กำหนดค่าได้ลงในหน้าเว็บหรือแอปบนอุปกรณ์เคลื่อนที่
- ตอบสนองต่อการโต้ตอบและเหตุการณ์ของผู้ใช้ใน Google Street View
- ปรับแต่งท่าทางสัมผัสที่ใช้ได้กับ Google Street View
- สร้างภาพเคลื่อนไหวของการเคลื่อนกล้องสำหรับ Google Street View