Places SDK สำหรับเวอร์ชัน Android

เลือกแพลตฟอร์ม: Android iOS JavaScript

ทีม Google Maps Platform จะอัปเดต SDK เป็นประจำด้วยฟีเจอร์ใหม่ๆ การแก้ไขข้อบกพร่อง และการปรับปรุงประสิทธิภาพ หน้านี้จะให้คำแนะนำเกี่ยวกับวิธีจัดการทรัพยากร Dependency ใน SDK บนอุปกรณ์เคลื่อนที่

  • สำหรับแอปที่มีความสำคัญต่อภารกิจ ให้ลิงก์กับเวอร์ชันย่อยล่าสุดของเวอร์ชันหลักที่คุณใช้อยู่ (X.*) และอัปเกรดเป็นเวอร์ชันหลักใหม่ทุกปี

    เมื่อคุณเปิดตัวแอปพลิเคชันเวอร์ชันใหม่ตลอดทั้งปี คุณอาจเริ่มใช้ Places SDK สำหรับ Android เวอร์ชันย่อยที่ใหม่กว่า การดำเนินการนี้ไม่จำเป็นต้องมีการอัปเดตในแอปพลิเคชันของคุณ เนื่องจากเวอร์ชันย่อยใหม่จะเข้ากันได้แบบย้อนหลัง

    ข้อดี

    • หากพบปัญหาใน Places SDK สำหรับ Android เราจะแก้ไขปัญหาในลักษณะที่เข้ากันได้แบบย้อนหลังเป็นเวลา 12 เดือนหลังจากการเปิดตัวเวอร์ชันหลักครั้งแรก ตามนโยบายการสนับสนุนอุปกรณ์เคลื่อนที่ คุณไม่จำเป็นต้องอัปเกรดเป็น SDK เวอร์ชันที่ไม่เข้ากันอย่างเร่งด่วนเพื่อรับประโยชน์จากการแก้ไข
    • การปรับปรุงและฟีเจอร์ล่าสุดจะนำไปใช้ได้ง่ายเมื่อแอปของคุณสร้างขึ้นในเวอร์ชันล่าสุดอยู่แล้ว
    • การอัปเดต SDK เวอร์ชันหลักใหม่ล่าสุดที่เพิ่มขึ้นทุกปีอาจต้องใช้การปรับเปลี่ยน เขียนใหม่ และทดสอบแอปพลิเคชันน้อยกว่าการจัดการกับการเปลี่ยนแปลงที่ไม่เข้ากันแบบย้อนหลังซึ่งเปิดตัวในเวอร์ชันหลักหลายๆ เวอร์ชัน

  • สำหรับแอปที่ไม่สำคัญ ให้ลิงก์ไปยังเวอร์ชันที่แก้ไขแล้ว เมื่อได้รับการแจ้งเตือนการเลิกใช้งานสำหรับเวอร์ชันที่แก้ไขแล้ว คุณจะมีเวลา 12 เดือนในการทำให้โค้ดแอปที่อัปเดตพร้อมใช้งานสำหรับผู้ใช้

    ข้อดี

    • งานบำรุงรักษาที่ถี่น้อยลง
    • แอปเวอร์ชันใหม่จะยังคงรองรับอุปกรณ์ของผู้ใช้ที่ใช้ระบบปฏิบัติการบนอุปกรณ์เคลื่อนที่เวอร์ชันก่อนหน้าได้นานขึ้น (จนกว่าคุณจะต้องอัปเกรดเป็น SDK เวอร์ชันใหม่)

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

การติดตั้ง

ในไฟล์ build.gradle.kts หรือ build.gradle ระดับแอป ให้ระบุเวอร์ชันเสมอแทนช่วงคำนำหน้า (+) หรือ latest เนื่องจากอาจทำให้เกิดบิลด์ที่คาดเดาไม่ได้และทำซ้ำไม่ได้ Places SDK สำหรับ Android เป็นไปตามการกำหนดเวอร์ชันเชิงความหมาย และการเปิดตัวเวอร์ชันหลักใหม่อาจรวมถึงการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ ระดับ API ขั้นต่ำที่รองรับคือ 24

dependencies {

    // Places and Maps SDKs
    implementation("com.google.android.libraries.places:places:6.0.2")
}

การบำรุงรักษาและการอัปเกรด

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

นอกจากการตรวจสอบเวอร์ชันใหม่แล้ว เจ้าของโปรเจ็กต์ Google Cloud จะได้รับอีเมลเกี่ยวกับการเปลี่ยนแปลงที่ไม่เข้ากันแบบย้อนหลังซึ่งอาจส่งผลต่อโปรเจ็กต์ของตน หากต้องการรับการแจ้งเตือนเชิงรุกเกี่ยวกับการเปลี่ยนแปลงที่ไม่เข้ากันแบบย้อนหลัง ให้มอบหมายบทบาทเจ้าของด้วยอีเมลที่มีการตรวจสอบสำหรับแต่ละโปรเจ็กต์

หากคุณอัปเกรดจาก Places SDK สำหรับ Android เวอร์ชัน 3.2.0 หรือเก่ากว่า

คุณไม่จำเป็นต้องย้ายข้อมูลเมื่อเปลี่ยนไปใช้ SDK ใหม่ คุณเพียงแค่ต้องทำดังนี้

  1. เปิดใช้ Places API (ใหม่) ในคีย์ API ที่ใช้ในแอป ดูข้อมูลเพิ่มเติมได้ที่การใช้คีย์ API

  2. ในส่วน dependencies ของไฟล์ build.gradle ระดับโมดูล ให้อัปเดตทรัพยากร Dependency places และเพิ่มทรัพยากร Dependency kotlin-bom

      dependencies {
      implementation(platform("org.jetbrains.kotlin:kotlin-bom:1.8.0"))
      implementation 'com.google.android.libraries.places:places:3.5.0'
  }

    ดูข้อมูลเพิ่มเติมเกี่ยวกับการขึ้นต่อกันของ kotlin-bom ได้ที่การใช้ kotlin-stdlib เวอร์ชันล่าสุดในการขึ้นต่อกันแบบทรานซิทีฟ

  3. อัปเดตแอปที่มีอยู่เพื่อเรียกใช้เมธอด Places.initializeWithNewPlacesApiEnabled() ใหม่เพื่อเริ่มต้นแอป ดูข้อมูลเพิ่มเติมได้ที่เริ่มต้นไคลเอ็นต์ Places API

แอปที่มีอยู่จะยังคงทำงานต่อไปโดยไม่มีการเปลี่ยนแปลง แต่ตอนนี้คุณสามารถใช้ประโยชน์จากฟีเจอร์ SDK ใหม่ทั้งหมดได้แล้ว