SDK Địa điểm dành cho mẫu mã iOS

Ứng dụng minh hoạ Places SDK cho iOS trên GitHub được cung cấp cùng với Places SDK cho iOS minh hoạ một số tính năng, bao gồm cả Place Autocomplete và Place Photos. Ngoài ra, bạn có thể tìm thấy các đoạn mã trên mỗi trang của hướng dẫn này dành cho nhà phát triển. Nhập và tạo ứng dụng, thêm khoá API, xem bản minh hoạ và sử dụng mã mẫu được cung cấp làm điểm xuất phát cho ứng dụng của bạn.

Khi bạn chạy ứng dụng mẫu, ứng dụng này sẽ hiển thị danh sách các mẫu có sẵn mà bạn có thể chạy trên thiết bị của riêng mình. Chọn một trong các lựa chọn.

Chạy toàn bộ ứng dụng mẫu trên thiết bị

Ứng dụng mẫu Places SDK for iOS có sẵn dưới dạng tệp lưu trữ có thể tải xuống trên GitHub. Hãy làm theo các bước sau để cài đặt và dùng thử ứng dụng mẫu Places SDK for iOS.

1. Tải tệp lưu trữ mã mẫu xuống từ GitHub rồi giải nén tệp lưu trữ đó. Ngoài ra, hãy sao chép kho lưu trữ vào một thư mục cục bộ:

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

2. Mở cửa sổ dòng lệnh, chuyển đến thư mục nơi bạn mở rộng các tệp mẫu và đi sâu vào thư mục cho phiên bản mà bạn muốn sử dụng:

   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. Trong dự án Xcode, hãy chuyển đến File (Tệp) > Add Package Dependencies (Thêm phần phụ thuộc của gói). Nhập https://github.com/googlemaps/ios-places-sdk làm URL, nhấn Enter để kéo gói vào và nhấp vào Add Package (Thêm gói).
4. Bật SDK Địa điểm dành cho iOS và SDK bản đồ dành cho iOS cho dự án trên bảng điều khiển Cloud của Google.
5. Lấy khoá API từ dự án của bạn khi Places API và/hoặc Places API (mới) được bật.
6. Thêm khoá API vào ứng dụng bằng cách làm theo hướng dẫn thích hợp bên dưới.

   SwiftUI

   Tạo một tệp cấu hình cục bộ có tên là GooglePlacesDemos.xcconfig cho khoá API của bạn, trong cùng thư mục với tệp Info.plist của ứng dụng minh hoạ (GooglePlacesDemos/GooglePlacesDemos).

   Thêm 2 dòng vào tệp cấu hình để xác định khoá API:

   PLACES_API_KEY = YOUR_PLACES_API_KEY và MAPS_API_KEY = YOUR_MAPS_API_KEY.

   Thay thế YOUR_PLACES_API_KEY và YOUR_MAPS_API_KEY bằng các khoá API ở các bước trước.

   Hãy xem Định dạng tệp chế độ cài đặt cấu hình (xcconfig) để biết cách tạo tệp cấu hình cục bộ.

   Swift

   Chỉnh sửa tệp SDKDemoAPIKey và dán khoá API vào hằng số thích hợp. Ví dụ:

   let placesAPIKey = "YOUR_API_KEY"

   Nếu có, hãy xoá dòng sau:

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

   Nếu Xcode nhắc bạn mở khoá tệp SDKDemoAPIKey để chỉnh sửa, hãy chọn Mở khoá.

   Objective-C

   Chỉnh sửa tệp SDKDemoAPIKey và dán khoá API vào hằng số thích hợp. Ví dụ:

   static NSString *const kAPIKey = @"YOUR_API_KEY";

   Nếu có, hãy xoá dòng sau

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

   Nếu Xcode nhắc bạn mở khoá tệp SDKDemoAPIKey để chỉnh sửa, hãy chọn Mở khoá.

7. Tạo ứng dụng.
8. Nếu bản dựng không thành công hoặc ứng dụng gặp sự cố kèm theo lỗi về khoá API khi bạn kích hoạt ứng dụng lần đầu, hãy đảm bảo rằng bạn đã cung cấp các khoá bắt buộc trong hướng dẫn ở trên.
9. Nếu bạn chạy ứng dụng mẫu, cửa sổ trình mô phỏng iOS sẽ cho thấy danh sách Các bản minh hoạ về địa điểm.
10. Nếu được nhắc cho phép ứng dụng minh hoạ truy cập vào vị trí của bạn, hãy chọn Cho phép.
11. Mẫu bạn chọn hiện đã sẵn sàng để chạy.