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

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

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

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

การแก้ปัญหา: หากแอปตัวอย่างทํางานได้สําเร็จแต่คุณไม่เห็นแผนที่ ให้ตรวจสอบว่าคุณได้เพิ่มคีย์ API ลงในไฟล์ Manifest ของแอปตามที่อธิบายไว้ในการใช้คีย์ API แล้ว

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

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

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 ให้ไปที่ไฟล์ > เพิ่มทรัพยากร Dependency ของแพ็กเกจ ป้อน https://github.com/googlemaps/ios-places-sdk เป็น URL แล้วกด Enter เพื่อดึงแพ็กเกจ จากนั้นคลิกเพิ่มแพ็กเกจ
4. เปิดใช้ Places SDK สำหรับ iOS สำหรับโปรเจ็กต์ Google Cloud Console
5. รับคีย์ API จากโปรเจ็กต์ที่เปิดใช้ Places API และ/หรือ Places API (ใหม่)
6. เพิ่มคีย์ API ลงในแอปโดยใช้คำสั่งที่เหมาะสมด้านล่าง

   SwiftUI

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

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

   PLACES_API_KEY = YOUR_PLACES_API_KEY

   แทนที่ YOUR_PLACES_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. ตัวอย่างที่คุณเลือกพร้อมใช้งานแล้ว