Tổng quan về mã mẫu

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

Ứng dụng minh họa SDK được cung cấp cùng với SDK địa điểm dành cho iOS minh họa một số tính năng, bao gồm cả 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 đoạn mã trên từng trang của hướng dẫn này.

Dùng thử CocoaPods để minh hoạ các bản minh hoạ SDK

SDK Địa điểm dành cho iOS được cung cấp dưới dạng nhóm CocoaPods. CocoaPods là trình quản lý phần phụ thuộc nguồn mở cho các dự án Swift và Objective-C Cocoa.

SDK Địa điểm dành cho iOS cung cấp một tập hợp các ứng dụng SDK minh hoạ mà bạn có thể cài đặt và chạy bằng lệnh pod try:

Làm theo các bước sau để cài đặt CocoaPods và dùng thử SDK Địa điểm dành cho iOS:

  1. Nếu bạn chưa có công cụ CocoaPods, hãy cài đặt công cụ này trên macOS bằng cách chạy lệnh sau từ thiết bị đầu cuối. Để biết thông tin chi tiết, hãy xem Hướng dẫn bắt đầu sử dụng CocoaPods. 
    sudo gem install cocoapods
  2. Lấy tệp mẫu bằng một trong hai phương thức sau:

    Sử dụng tệp từ GitHub

    1. Tải tệp lưu trữ mã mẫu xuống từ GitHub và giải nén tệp lưu trữ đó.
    2. Mở cửa sổ dòng lệnh, chuyển đến thư mục mà bạn đã mở rộng các tệp mẫu và xem chi tiết thư mục Google Places:

      Swift

      cd maps-sdk-for-ios-samples-master/GooglePlaces-Swift

      Objective-C

      cd maps-sdk-for-ios-samples-master/GooglePlaces
    3. Chạy lệnh sau:
      pod install
      
open GooglePlacesDemos.xcworkspace

    Sử dụng CocoaPods v1.6.1

    1. Mở cửa sổ dòng lệnh và cài đặt phiên bản 1.6.1: 
      sudo gem install cocoapods -v1.6.1
    2. Tìm nạp tệp Google Địa điểm bằng CocoaPods: 
      pod try GooglePlaces

      CocoaPods cập nhật kho lưu trữ thông số kỹ thuật của bạn, sau đó mở bản minh hoạ SDK trong một dự án Xcode tạm thời, GooglePlacesDemos.xcworkspace.

  3. Bật Địa điểm SDK dành cho iOS cho dự án Google Cloud Console của bạn.
  4. Nếu bạn chưa có khoá API, hãy làm theo hướng dẫn thiết lập dự án trên Cloud Console và nhận khoá API. Khi định cấu hình khoá trên Cloud Console, bạn có thể chỉ định giá trị nhận dạng gói của ứng dụng để đảm bảo rằng chỉ ứng dụng của bạn mới có thể sử dụng khoá đó. Giá trị nhận dạng gói mặc định của ứng dụng mẫu SDK là com.example.GooglePlacesDemos.
  5. Chỉnh sửa tệp SDKDemoAPIKey rồi dán khoá API vào hằng số thích hợp. Ví dụ:

    Swift

    let placesAPIKey = "YOUR_API_KEY"

    Objective-C

    static NSString *const kAPIKey = @"YOUR_API_KEY";
  6. Nếu Xcode nhắc bạn mở khoá tệp SDKDemoAPIKey để chỉnh sửa, hãy chọn Mở khoá.
  7. Nếu có, hãy xoá dòng sau vì dòng này được dùng để đăng ký vấn đề:

    Swift

    #error (Đăng ký Khóa API và chèn vào đây. Sau đó, xóa dòng này.”)

    Objective-C

    #error Register your API key and insert here, then delete this line.
  8. Tạo bản dựng và chạy lại dự án.
  9. Nếu việc tạo bản dựng không thành công hoặc ứng dụng gặp lỗi với khoá API vào lần đầu tiên, hãy đảm bảo rằng bạn đã cung cấp các khoá được yêu cầu trong tệp SDKDemoAPIKey.
  10. Nếu bạn đang chạy bản minh hoạ trên Google Places, cửa sổ trình mô phỏng iOS sẽ hiển thị danh sách demo Demo.
  11. Nếu bạn được nhắc cho phép Google Placesdemos truy cập vào vị trí của mình, hãy chọn Allow (Cho phép).
  12. Mẫu bạn chọn hiện đã sẵn sàng để chạy.

Sử dụng đoạn mã từ hướng dẫn của nhà phát triển

Mỗi trang trong hướng dẫn cho nhà phát triển đều bao gồm các đoạn mã minh hoạ một tính năng cụ thể của API. Ví dụ: xem hướng dẫn về tính năng tự động hoàn thành, nhận địa điểm hiện tại, ảnh và các trang khác trong hướng dẫn này.