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

Chọn nền tảng: Android iOS JavaScript

Ứng dụng minh hoạ Places SDK cho iOS trên GitHub đi kèm với Places SDK cho iOS minh hoạ một số tính năng, bao gồm cả tính năng Tự động hoàn thành địa điểm và Ảnh địa điểm. 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 bắt đầu 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ữ đó. Hoặc 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 Places SDK for iOS cho dự án trên Google Cloud Console.
  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 một dòng vào tệp cấu hình để xác định khoá API:

    PLACES_API_KEY = YOUR_PLACES_API_KEY

    Thay thế YOUR_PLACES_API_KEY bằng 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 chạy ứ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.