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 Maps 3D dành cho iOS. Quy trình thiết lập bao gồm việc định cấu hình dự án và API trên Google Cloud để sử dụng với SDK, sau đó thiết lập 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 của bạn.
Thiết lập dự án trên đám mây và khoá API trên Google Cloud
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 dự án trên đám mây và khoá API trên Google Cloud để 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
-
Trong bảng điều khiển Google Cloud, trên trang bộ chọn dự án, hãy nhấp vào Tạo dự án để bắt đầu tạo 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 Cloud. Xác nhận rằng bạn đã bật tính năng thanh toán cho dự án.
Google Cloud cung cấp bản dùng thử miễn phí. Bản dùng thử sẽ hết hạn vào cuối 90 ngày hoặc sau khi tài khoản tích luỹ được 300 USD phí, tuỳ vào trường hợp nào đến trước. Bạn có thể huỷ bất cứ lúc nào. Để biết thêm thông tin, hãy xem Khoản tín dụng trong 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
Để sử dụng Google Maps Platform, bạn phải bật các API hoặc SDK mà bạn dự định sử dụng với dự án của mình.
Xin lưu ý rằng một số công cụ tích hợp yêu cầu bạn bật nhiều API/SDK. Nếu bạn không chắc nên bật API hoặc SDK nào, hãy thử sử dụng Trình khám phá tính 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 chuyển đến trang Thư viện API Maps trong bảng điều khiển Cloud:
Chuyển đến trang Thư viện API Maps
- Nhấp vào API hoặc SDK mà bạn muốn bật.
- Nếu nút này có nội dung là BẬT, hãy nhấp vào nút đó để bật API hoặc SDK.
- Nếu nút này có nội dung là QUẢN LÝ, thì API hoặc SDK đã được bật và bạn không cần làm gì thêm.
- Khi bạn nhấp vào nút này, trang tổng quan cho API hoặc SDK sẽ xuất hiện. (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 sẽ bật tất cả API Maps, Tuyến đường và Địa điểm:
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 API Môi trường:
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 bạn sử dụng Khoá API trong quá trình phát hành chính thức, bạn nên hạn chế khoá API. 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à giá trị nhận dạng duy nhất giúp xác thực các yêu cầu liên kết với 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
-
Chuyển đến trang Google Maps Platform > Thông tin xác thực.
-
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 Khoá API đã tạo sẽ cho thấy khoá API mới tạo. -
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.
(Hãy nhớ hạn chế khoá API trước khi sử dụng trong quá trình phát hành 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ách 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 bảng điều khiển Cloud. Để 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 đã sẵn sàng 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
Để xây dựng 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 dành cho iOS bằng Trình quản lý gói Swift.
Để thêm SDK vào 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 Enter để kéo gói vào và nhấp vào "Add Package" (Thêm gói).
- Trong cửa sổ Choose Package Products (Chọn sản phẩm của gói), hãy xác minh rằng
GoogleMaps3Dsẽ được thêm vào mục tiêu chính được chỉ định. Sau khi hoàn tất, hãy nhấp vào Add Package (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 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) trong 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.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 cung cấp thông tin chi tiết về quyền riêng tư trong ứng dụng cho 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, bạn đã thiết lập dự án trên đám mây, khoá API và dự án Xcode trên Google Cloud để sử dụng với SDK Maps 3D dành cho iOS, bạn có thể Thêm bản đồ 3D vào ứng dụng của mình.