Places SDK สำหรับตัวอย่างโค้ดของ iOS

แอปเดโม Places SDK สำหรับ iOS บน GitHub ที่มาพร้อมกับ Places SDK สำหรับ iOS แสดงฟีเจอร์ต่างๆ มากมาย รวมถึง Place Autocomplete และ Place Photos นอกจากนี้ คุณยังดูข้อมูลโค้ดได้ในแต่ละหน้าของคู่มือนักพัฒนาซอฟต์แวร์ฉบับนี้ นำเข้าและสร้างแอป เพิ่มคีย์ API ดูเดโม และใช้โค้ดตัวอย่างที่ให้ไว้เป็นจุดเริ่มต้นสำหรับแอป

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

เรียกใช้แอปตัวอย่างฉบับเต็มในเครื่อง

GitHub

1. ดาวน์โหลด ไฟล์เก็บถาวรของตัวอย่างโค้ด จาก GitHub แล้วแตกไฟล์ หรือโคลนที่เก็บลงในไดเรกทอรีในเครื่องโดยใช้คำสั่งต่อไปนี้

   git clone https://github.com/googlemaps-samples/ios-places-sdk-samples.git

2. เปิดหน้าต่างเทอร์มินัล ไปที่ไดเรกทอรีที่คุณแตกไฟล์ตัวอย่าง แล้ว เจาะลึกลงไปในไดเรกทอรีของเวอร์ชันที่ต้องการใช้

   SwiftUI

   cd ios-places-sdk-samples/GooglePlacesDemos/
   open GooglePlacesDemos.xcodeproj

   Swift

   cd ios-places-sdk-samples/GooglePlaces-Swift/
   open GooglePlacesSwiftDemos.xcodeproj

   Objective-C

   cd ios-places-sdk-samples/Archive/GooglePlaces
   open GooglePlacesXCFrameworkDemos.xcodeproj

3. ในโปรเจ็กต์ Xcode ให้ไปที่ File > Add Package Dependencies ป้อน https://github.com/googlemaps/ios-places-sdk เป็น URL กด Enter เพื่อดึงแพ็กเกจ แล้วคลิก Add Package
4. เปิดใช้ Places SDK สำหรับ iOS และ Maps SDK สำหรับ iOS สำหรับโปรเจ็กต์คอนโซล Google Cloud
5. รับคีย์ API จากโปรเจ็กต์ที่เปิดใช้ Places API และ/หรือ Places API (ใหม่)
6. เพิ่มคีย์ API ลงในแอปโดยใช้คำแนะนำที่เหมาะสมด้านล่าง

   SwiftUI

   สร้างไฟล์การกำหนดค่าในเครื่องชื่อ GooglePlacesDemos.xcconfig สำหรับคีย์ API ในไดเรกทอรีเดียวกับไฟล์ Info.plist ของแอปพลิเคชันเดโม (GooglePlacesDemos/GooglePlacesDemos)

   เพิ่ม 2 บรรทัดลงในไฟล์การกำหนดค่าเพื่อกำหนดคีย์ API ดังนี้

   PLACES_API_KEY = YOUR_PLACES_API_KEY และ MAPS_API_KEY = YOUR_MAPS_API_KEY

   แทนที่ YOUR_PLACES_API_KEY และ YOUR_MAPS_API_KEY ด้วยคีย์ API จากขั้นตอนก่อนหน้า

   ดูความช่วยเหลือเกี่ยวกับการสร้างไฟล์การกำหนดค่าในเครื่องได้ที่รูปแบบไฟล์การตั้งค่าการกำหนดค่า (xcconfig)

   Swift

   แก้ไขไฟล์ SDKDemoAPIKey แล้ววางคีย์ API ลงในค่าคงที่ที่เหมาะสม เช่น

   let placesAPIKey = "YOUR_API_KEY"

   หากมี ให้ลบบรรทัดต่อไปนี้

   #error (Register for API Key and insert here. Then delete this line.)

   หาก Xcode แจ้งให้คุณปลดล็อกไฟล์ SDKDemoAPIKey เพื่อ แก้ไข ให้เลือกปลดล็อก

   Objective-C

   แก้ไขไฟล์ SDKDemoAPIKey แล้ววางคีย์ API ลงในค่าคงที่ที่เหมาะสม เช่น

   static NSString *const kAPIKey = @"YOUR_API_KEY";

   หากมี ให้ลบบรรทัดต่อไปนี้

   #error (Register for API Key and insert here. Then delete this line.)

   หาก Xcode แจ้งให้คุณปลดล็อกไฟล์ SDKDemoAPIKey เพื่อ แก้ไข ให้เลือกปลดล็อก

7. สร้างแอป
8. หากบิลด์ล้มเหลวหรือแอปขัดข้องโดยมีข้อผิดพลาดเกี่ยวกับคีย์ API เมื่อคุณเรียกใช้แอปเป็นครั้งแรก ให้ตรวจสอบว่าคุณได้ระบุ คีย์ที่จำเป็นในคำแนะนำด้านบนแล้ว
9. หากคุณเรียกใช้แอปตัวอย่าง หน้าต่างโปรแกรมจำลอง iOS จะแสดงรายการเดโมของ Places
10. หากระบบแจ้งให้คุณอนุญาตให้แอปเดโมเข้าถึงตำแหน่งของคุณ ให้เลือก อนุญาต
11. ตอนนี้ตัวอย่างที่คุณเลือกพร้อมทำงานแล้ว