Thiết lập

Trang này mô tả những việc bạn cần làm để thiết lập và bắt đầu xây dựng bằng SDK 3D của Maps cho iOS. Quá trình thiết lập bao gồm việc định cấu hình một dự án trên đám mây của Google Cloud và API để sử dụng với SDK, sau đó thiết lập một dự án Xcode. Hãy hoàn tất các bước này trước khi thêm bản đồ 3D đầu tiên vào ứng dụng.

Điều kiện tiên quyết

Để sử dụng SDK Maps 3D cho iOS, dự án và thiết bị mục tiêu của bạn phải đáp ứng các yêu cầu sau:

  • Phiên bản iOS tối thiểu: Nhắm đến iOS 16.0 trở lên.
  • Xcode: Xcode phiên bản 16.0 trở lên.

Thiết lập dự án trên đám mây của Google Cloud và khoá API

Trước khi có thể bắt đầu xây dựng bằng SDK Maps 3D dành cho iOS, bạn cần thiết lập một dự án trên đám mây của Google Cloud và khoá API để sử dụng với SDK Maps 3D dành cho iOS bằng cách hoàn tất các bước sau:

Bước 1

Giao diện dòng lệnh

  1. Trong Google Cloud Console, trên trang bộ chọn dự án, hãy nhấp vào Create Project (Tạo dự án) để bắt đầu tạo một dự án mới trên Cloud.

    Chuyển đến trang bộ chọn dự án

  2. Đảm bảo rằng bạn đã bật tính năng thanh toán cho dự án trên đám mây của bạn. Xác nhận rằng bạn đã bật tính năng thanh toán cho dự án của mình.

    Google Cloud cung cấp gói dùng thử không tính phí. Bản dùng thử sẽ hết hạn sau 90 ngày hoặc sau khi tài khoản đã tích luỹ được khoản phí trị giá 300 USD, tuỳ theo điều kiện nào đến trước. Huỷ bất cứ lúc nào. Để biết thêm thông tin, hãy xem phần Tín dụng tài khoản thanh toán và Thanh toán.

SDK đám mây

gcloud projects create "PROJECT"

Đọc thêm về Google Cloud SDK , Cài đặt Cloud SDK và các lệnh sau:

Bước 2

Để sử dụng Google Maps Platform, bạn phải bật các API hoặc SDK mà bạn dự định dùng cho dự án của mình.

Xin lưu ý rằng một số hoạt động tích hợp yêu cầu bạn bật nhiều API/SDK. Nếu bạn không chắc chắn nên bật API hoặc SDK nào, hãy thử sử dụng Trình khám phá chức năng hoặc tham khảo tài liệu về API/SDK mà bạn muốn sử dụng.

Cách bật một hoặc nhiều API hoặc SDK:

Giao diện dòng lệnh

  1. Xem các API và SDK của Google Maps Platform mà bạn có thể bật bằng cách truy cập vào trang Thư viện API Maps trong Cloud Console:

    Chuyển đến trang Thư viện API Maps

  2. Nhấp vào API hoặc SDK mà bạn muốn bật.
    • Nếu nút này có nhãn BẬT, hãy nhấp vào nút đó để bật API hoặc SDK.
    • Nếu nút này có nhãn MANAGE (QUẢN LÝ), thì tức là API hoặc SDK đã được bật và bạn không cần làm gì thêm.
    • Khi nhấp vào một trong hai nút, bạn sẽ thấy trang tổng quan của API hoặc SDK. (Nhấp vào nút TẮT để xoá API hoặc SDK khỏi dự án này.)

SDK đám mây

Lệnh sau đây bật tất cả các API Maps, Routes và Places:

gcloud services enable \
    --project "PROJECT" \
    "addressvalidation.googleapis.com" \
    "areainsights.googleapis.com" \
    "tile.googleapis.com" \
    "aerialview.googleapis.com" \
    "elevation-backend.googleapis.com" \
    "routes.googleapis.com" \
    "geocoding-backend.googleapis.com" \
    "geolocation.googleapis.com" \
    "maps-android-backend.googleapis.com" \
    "maps-backend.googleapis.com" \
    "maps-embed-backend.googleapis.com" \
    "maps-ios-backend.googleapis.com" \
    "mapsplatformdatasets.googleapis.com" \
    "places-backend.googleapis.com" \
    "roads.googleapis.com" \
    "routeoptimization.googleapis.com" \
    "static-maps-backend.googleapis.com" \
    "street-view-image-backend.googleapis.com" \
    "timezone-backend.googleapis.com"

Đọc thêm về Google Cloud SDK , Cài đặt Cloud SDK và các lệnh sau:

Sử dụng lệnh này để bật Environment API:

gcloud services enable \
    --project "PROJECT" \
    "airquality.googleapis.com" \
    "solar.googleapis.com" \
    "pollen.googleapis.com" \
    "weather.googleapis.com"

Bước 3

Bước này chỉ hướng dẫn quy trình tạo Khoá API. Nếu sử dụng khoá API trong môi trường thực tế, bạn nên hạn chế khoá API của mình. Bạn có thể tìm thêm thông tin trên trang Sử dụng khoá API dành riêng cho sản phẩm.

Khoá API là một giá trị nhận dạng riêng biệt giúp xác thực các yêu cầu liên quan đến dự án của bạn cho mục đích sử dụng và thanh toán. Bạn phải có ít nhất một khoá API liên kết với dự án của mình.

Cách tạo khoá API:

Giao diện dòng lệnh

  1. Chuyển đến trang Google Maps Platform > Thông tin xác thực.

    Chuyển đến trang Thông tin đăng nhập

  2. Trên trang Thông tin xác thực, hãy nhấp vào Tạo thông tin xác thực > Khoá API.
    Hộp thoại Đã tạo khoá API sẽ hiển thị khoá API bạn vừa tạo.
  3. Nhấp vào Đóng.
    Khoá API mới sẽ xuất hiện trên trang Thông tin xác thực trong phần Khoá API.
    (Nhớ hạn chế khoá API trước khi sử dụng trong phiên bản chính thức.)

SDK đám mây

gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

Đọc thêm về Google Cloud SDK , Cài đặt Cloud SDK và các lệnh sau:

Để bật SDK, hãy xem trang SDK Maps 3D dành cho iOS trong Google Cloud Console. Để biết thêm thông tin về cách hoàn tất các bước này, hãy xem bài viết Bắt đầu sử dụng Google Maps Platform.

Thiết lập dự án Xcode

Phần này giải thích cách tạo và định cấu hình dự án Xcode để sử dụng với SDK Maps 3D dành cho iOS.

Sau khi bật tính năng thanh toán và tạo khoá API, bạn có thể thiết lập dự án Xcode mà bạn dùng để phát triển ứng dụng.

Bước 1: Cài đặt phần mềm cần thiết

Để tạo một dự án bằng SDK Maps 3D dành cho iOS, bạn phải tải xuống và cài đặt:

  • Xcode phiên bản 16.0 trở lên

Bước 2: Tạo dự án Xcode và cài đặt SDK Maps 3D dành cho iOS

Trình quản lý gói Swift

Bạn có thể cài đặt SDK Maps 3D cho iOS bằng Trình quản lý gói Swift.

Để thêm SDK vào một dự án mới hoặc hiện có, hãy làm theo các bước sau:

  • Mở project hoặc workspace Xcode, sau đó 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-maps-3d-sdk làm URL, nhấn phím Enter để lấy gói, rồi nhấp vào "Add Package" (Thêm gói).
  • Trong cửa sổ Choose Package Products (Chọn sản phẩm trong gói), hãy xác minh rằng GoogleMaps3D sẽ được thêm vào mục tiêu chính mà bạn chỉ định. Sau khi hoàn tất, hãy nhấp vào Thêm gói.
  • Để xác minh quá trình cài đặt, hãy chuyển đến ngăn General (Chung) của mục tiêu. Trong phần Frameworks, Libraries, and Embedded Content (Khung, thư viện và nội dung được nhúng), bạn sẽ thấy các gói đã cài đặt. Bạn cũng có thể xem phần Package Dependencies (Phần phụ thuộc của gói) của Project Navigator (Trình điều hướng dự án) để xác minh gói và phiên bản của gói.

Bước 3: Thêm khoá API vào ứng dụng

Trình quản lý gói Swift

Thêm khoá API vào điểm truy cập chính cho ứng dụng (hoặc bất cứ lúc nào trước khi bản đồ tải) như sau.

  1. Thêm câu lệnh nhập sau:
    import GoogleMaps3D
  2. Thêm phương thức sau. Thay thế YOUR_API_KEY bằng khoá API của bạn.
    struct ContentView: View {
      init () {
        Map.apiKey = "YOUR_API_KEY"
      }
    
      var body: some View {
        Map(mode: .hybrid)
      }
    }
        

Bước 4 (không bắt buộc): Kiểm tra tệp kê khai về quyền riêng tư của Apple

Apple yêu cầu các ứng dụng trên App Store phải cung cấp thông tin chi tiết về quyền riêng tư của ứng dụng.

Tệp kê khai về quyền riêng tư của Apple có trong gói tài nguyên cho SDK. Để xác minh rằng Tệp kê khai về quyền riêng tư đã được đưa vào và để kiểm tra nội dung của tệp này, hãy tạo một kho lưu trữ cho ứng dụng của bạn và tạo báo cáo về quyền riêng tư từ kho lưu trữ đó.

Các bước tiếp theo

Giờ đây, khi đã có một dự án trên đám mây của Google Cloud, khoá API và dự án Xcode được thiết lập để sử dụng với Maps 3D SDK cho iOS, bạn có thể Thêm bản đồ 3D vào ứng dụng của mình.