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 Maps dành cho iOS bao gồm các mẫu nổi bật của tính năng của SDK. Hãy kiểm tra mã trong ứng dụng minh hoạ để xem cách triển khai từng mẫu.

Thử bản minh họa SDK

SDK bản đồ dành cho iOS SDK có sẵn dưới dạng một bản lưu trữ tải xuống từ GitHub và 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.

Hãy làm theo các bước sau để cài đặt và dùng thử SDK Maps dành cho iOS.

  1. Lấy tệp mẫu bằng một trong hai phương pháp sau:

    Trực tiếp từ GitHub

    1. Tải tệp lưu trữ mã mẫu xuống qua 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 tệp mẫu và xem chi tiết thư mục Google Maps:

      Swift

      cd maps-sdk-for-ios-samples-main/GoogleMaps-Swift

      Objective-C

      cd maps-sdk-for-ios-samples-main/GoogleMaps
    3. Chạy các lệnh sau:

      Swift

      pod install
      open GoogleMapsSwiftDemos.xcworkspace

      Objective-C

      pod install
      open GoogleMapsDemos.xcworkspace

    Sử dụng CocoaPods v1.6.1

    1. Nếu bạn chưa có công cụ CocoaPods, hãy cài đặt phiên bản 1.6.1 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 -v1.6.1
    2. Tìm nạp các tệp Google Maps bằng Cocoapods:
      pod try GoogleMaps

      Chọn Swift hoặc Objective-C khi được nhắc. 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ạ trong dự án Xcode tạm thời có tên là SwiftDemoApp.xcodeproj hoặc ObjCDemoApp.xcodeproj.

  2. Trong Xcode, hãy nhấn nút biên dịch để xây dựng rồi chạy lược đồ hiện tại. Nếu bản dựng gây ra lỗi, hãy nhắc bạn nhập khoá API vào tệp SDKConstants.swift cho Swift hoặc SDKDemoAPIKey.h trong tệp Objective-C.
  3. Nếu bạn chưa có khoá API, hãy làm theo hướng dẫn để thiết lập một dự án trên Google 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 chỉ ứng dụng đó 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.GoogleMapsDemos.
  4. Chỉnh sửa tệp SDKConstants.swift cho Swift hoặcSDKDemoAPIKey.h cho Objective-C và dán khoá API vào định nghĩa của hằng số apiKey hoặc kAPIKey. Ví dụ:

    Swift

    static let apiKey = "YOUR_API_KEY"

    Objective-C

    static NSString *const kAPIKey = @"YOUR_API_KEY";
  5. Xóa dòng sau vì dòng này được dùng để đăng ký vấn đề do người dùng xác định:

    Swift

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

    Objective-C

    #error Register for API Key and insert here.
  6. Tạo bản dựng và chạy dự án. Cửa sổ trình mô phỏng iOS sẽ xuất hiện, hiển thị danh sách Maps SDK Demo.
  7. Hãy chọn một trong các tùy chọn được hiển thị để thử nghiệm tính năng của SDK SDK dành cho iOS.
  8. Nếu được nhắc cho phép GoogleMapsdemo truy cập thông tin vị trí của bạn, hãy chọn Cho phép.

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

Mỗi trang trong hướng dẫn dành cho nhà phát triển có chứa 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 cho đối tượng bản đồ, điểm đánh dấu, hình dạng và các trang khác trong hướng dẫn này.