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

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

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

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

ลิงก์กับเวอร์ชันใด

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

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

  ข้อดี

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

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

  ข้อดี

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

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

การติดตั้ง

Swift Package Manager

คุณติดตั้ง Places SDK สำหรับ iOS ได้ผ่าน Swift Package Manager หากต้องการเพิ่ม SDK ให้ตรวจสอบว่าคุณได้นำทรัพยากร Dependency ของ Places SDK สำหรับ iOS ที่มีอยู่ออกแล้ว

หากต้องการเพิ่ม SDK ลงในโปรเจ็กต์ใหม่หรือโปรเจ็กต์ที่มีอยู่ ให้ทำตามขั้นตอนต่อไปนี้

1. เปิด Xcode project หรือ workspace แล้วไปที่ไฟล์ > เพิ่มทรัพยากร Dependency ของแพ็กเกจ
2. ป้อน https://github.com/googlemaps/ios-places-sdk เป็น URL แล้วกด Enter เพื่อดึงแพ็กเกจเข้ามา แล้วคลิก "Add Package"
3. หากต้องการติดตั้ง version ที่เฉพาะเจาะจง ให้ตั้งค่าช่องกฎการขึ้นต่อกันเป็นตัวเลือกตามเวอร์ชันตัวเลือกใดตัวเลือกหนึ่ง สําหรับโปรเจ็กต์ใหม่ เราขอแนะนําให้ระบุเวอร์ชันล่าสุดและใช้ตัวเลือก "เวอร์ชันที่แน่นอน" เมื่อเสร็จแล้ว ให้คลิก "เพิ่มแพ็กเกจ"
4. จากหน้าต่างเลือกผลิตภัณฑ์แพ็กเกจ ให้ยืนยันว่าระบบจะเพิ่ม GooglePlaces, GooglePlacesSwift หรือทั้ง 2 รายการลงในเป้าหมายหลักที่กำหนด เมื่อเสร็จแล้ว ให้คลิกเพิ่มแพ็กเกจ

   หากคุณกำลังอัปเดต Google Places Swift จาก URL ของ GitHub ที่เลิกใช้งานแล้ว

   สำคัญ: URL ของ GitHub สำหรับเข้าถึง Google Places Swift มีการเปลี่ยนแปลงตั้งแต่เวอร์ชัน 0.3.0 เป็นต้นไป หากคุณกำลังอัปเดต GooglePlacesSwift เวอร์ชันที่เข้าถึงผ่าน URL เก่า https://github.com/googlemaps/ios-places-swift-sdk ให้นำเวอร์ชันดังกล่าวออกจากส่วนทรัพยากร Dependency ของแพ็กเกจ Xcode

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

หากต้องการอัปเดต package สำหรับโปรเจ็กต์ที่มีอยู่ ให้ทำตามขั้นตอนต่อไปนี้

1. จาก Xcode ให้ไปที่ไฟล์ > แพ็กเกจ > อัปเดตเป็นเวอร์ชันแพ็กเกจล่าสุด

   หากคุณกำลังอัปเดต Google Places Swift จาก URL ของ GitHub ที่เลิกใช้งานแล้ว

   สำคัญ: URL ของ GitHub สำหรับเข้าถึง Google Places Swift มีการเปลี่ยนแปลงตั้งแต่เวอร์ชัน 0.3.0 เป็นต้นไป หากคุณกำลังอัปเดต GooglePlacesSwift เวอร์ชันที่เข้าถึงผ่าน URL เก่า https://github.com/googlemaps/ios-places-swift-sdk ให้นำเวอร์ชันดังกล่าวออกจากส่วนทรัพยากร Dependency ของแพ็กเกจ Xcode

2. หากต้องการยืนยันการติดตั้ง ให้ไปที่ส่วนทรัพยากร Dependency ของแพ็กเกจในเครื่องมือนำทางโปรเจ็กต์เพื่อยืนยันแพ็กเกจและเวอร์ชัน

สำคัญ: บางครั้งอาร์ติแฟกต์อาจไม่ได้รับการแก้ไขหรืออาจเกิดข้อผิดพลาด ในกรณีนี้ ให้เลือก "File > Packages > Reset Package Cache"

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

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

Swift Package Manager

To update the package for an existing project, follow these steps:

  

    
    
    

      To verify your installation, go to the Package Dependencies section of Project Navigator
      to verify the package and its version.
    
  
  
  

    Important: Sometimes, artifacts cannot be resolved or errors can occur, 
    in this case select "File > Packages > Reset Package Cache".
  

การติดตั้งด้วยตนเอง

รับลิงก์ไปยังไฟล์ต้นฉบับล่าสุดที่หัวข้อการติดตั้ง SDK

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