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

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

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

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

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

    ข้อดี

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

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

    ข้อดี

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

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

การติดตั้ง

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

dependencies {
    // If updating kotlin-bom version number above, also edit project-level build.gradle definition of $kotlin_version variable
    implementation(platform("org.jetbrains.kotlin:kotlin-bom:$kotlin_version"))
    implementation 'com.google.android.libraries.places:places:3.3.0'
}

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

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.3.0'
      }

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

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

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