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 dành 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: Thiết lập dự án
Giao diện dòng lệnh
-
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.
-
Đả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í. Thời gian dùng thử sẽ kết thúc sau 90 ngày hoặc sau khi tài khoản đã tích luỹ được 300 USD phí, 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ách cài đặt Cloud SDK và các lệnh sau:
Bước 2: Bật API hoặc SDK
Để 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
-
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
- Nhấp vào API hoặc SDK 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ách 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: Lấy khoá API
Bước này chỉ thực hiệ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. Để tạo khoá mới hoặc thêm API hay SDK vào khoá hiện có, hãy làm theo các hướng dẫn sau.
Giao diện dòng lệnh
-
Chuyển đến trang Google Maps Platform > Khoá và thông tin xác thực.
- Nếu thấy lời nhắc, hãy chọn dự án của bạn.
-
Thực hiện một trong các thao tác sau:
-
Tạo khoá mới:
- Nhấp vào Tạo thông tin xác thực > Khoá API.
- Trong bảng điều khiển Create API key (Tạo khoá API), hãy mở danh sách Select API restrictions (Chọn các quy định hạn chế đối với API).
- Xoá mọi API mà khoá này không cần và đảm bảo rằng các API mà bạn dự định sử dụng vẫn được chọn.
- Nhấp vào Tạo. Bảng điều khiển sẽ hiển thị khoá API mới của bạn.
-
Sử dụng khoá hiện có:
- Nhấp vào tên của khoá.
- Trong danh sách Select API restrictions (Chọn các quy tắc hạn chế cho API), hãy chọn những API mà bạn dự định sử dụng.
- Nhấp vào Lưu.
Việc chọn một API ở đây không giúp bật API đó. Đảm bảo rằng mỗi API bạn chọn đều được bật trong Thư viện API.
-
- Để xem chuỗi khoá sau này, hãy chuyển đến trang Khoá và thông tin xác thực rồi nhấp vào Hiện khoá cho khoá đó.
Nếu bảng điều khiển có giao diện khác với các bước này, hãy xem phần Tạo khoá API và Thêm quy định hạn chế về API trong tài liệu của Google Cloud.
SDK đám mây
Thay thế PROJECT_ID bằng mã dự án của bạn trong các lệnh sau.
-
Tạo khoá mới: Chạy lệnh sau và thay thế DISPLAY_NAME bằng tên cho khoá. Thay thế SERVICE_NAME bằng tên dịch vụ của một API mà bạn dự định sử dụng, chẳng hạn như
places.googleapis.com. Để cho phép thêm API, hãy lặp lại cờ--api-target.gcloud services api-keys create \ --project="PROJECT_ID" \ --display-name="DISPLAY_NAME" \ --api-target=service=SERVICE_NAME
Đọc thêm về Google Cloud SDK, cách cài đặt Cloud SDK và các lệnh sau:
-
Sử dụng khoá hiện có: Chạy lệnh sau và thay thế KEY_ID bằng mã nhận dạng của khoá. Thay thế SERVICE_NAME bằng tên dịch vụ của API cần thêm. Cờ
--appendgiữ lại các API mà khoá đã cho phép. Nếu không có, lệnh sẽ thay thế các tệp đó.gcloud services api-keys update KEY_ID \ --project="PROJECT_ID" \ --append \ --api-target=service=SERVICE_NAME
Đọc thêm về Google Cloud SDK, cách cài đặt Cloud SDK và các lệnh sau:
Mã khoá không phải là chuỗi khoá hoặc tên hiển thị. Để tìm tệp này, hãy chạy
gcloud services api-keys list --project="PROJECT_ID". Mã nhận dạng là phần cuối cùng của trườngname:projects/PROJECT_NUMBER/locations/global/keys/KEY_ID.
Để xem chuỗi khoá, hãy chạy gcloud services api-keys get-key-string KEY_ID
--project="PROJECT_ID".
Để 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ở
projecthoặcworkspaceXcode, 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
GoogleMaps3Dsẽ đượ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 của bạn (hoặc bất cứ lúc nào trước khi bản đồ tải) như sau.
- Thêm câu lệnh nhập sau:
import GoogleMaps3D
- Thêm phương thức sau. Thay thế
YOUR_API_KEYbằ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 thông tin chi tiết về quyền riêng tư của ứng dụng đối với các ứng dụng trên App Store.
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 SDK Maps 3D cho iOS, bạn có thể Thêm bản đồ 3D vào ứng dụng của mình.