Thiết lập

Sản phẩm hoặc tính năng này đang trong giai đoạn thử nghiệm (trước khi phát hành rộng rãi). Các sản phẩm và tính năng trước giai đoạn phát hành rộng rãi có thể bị hạn chế về dịch vụ hỗ trợ, đồng thời các thay đổi đối với các sản phẩm và tính năng trước giai đoạn phát hành rộng rãi có thể không tương thích với các phiên bản trước giai đoạn phát hành rộng rãi khác. Các Sản phẩm/dịch vụ ở giai đoạn trước khi phát hành rộng rãi tuân theo Điều khoản dành riêng cho dịch vụ của Nền tảng Google Maps. Để biết thêm thông tin, hãy xem nội dung mô tả về giai đoạn ra mắt.

Trang này mô tả những việc bạn cần làm để thiết lập và bắt đầu tạo bằng Maps 3D SDK cho iOS. Quy trình thiết lập bao gồm việc định cấu hình một dự án Google Cloud và API để sử dụng với SDK, sau đó thiết lập một dự án Xcode. Hoàn tất các bước sau 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 Google Cloud và khoá API

Trước khi có thể bắt đầu tạo bằng Maps 3D SDK cho iOS, bạn cần thiết lập một dự án Google Cloud và khoá API để sử dụng với Maps 3D SDK 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 chọn dự án, hãy nhấp vào Tạo dự án để bắt đầu tạo một dự án Cloud mới.

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

2. Đảm bảo 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 của mình.

   Google Cloud cung cấp bản 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 khoản phí trị giá 3.000.000 VND, 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 bài viết 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, quy trình cài đặt Cloud SDK và các lệnh sau:

• gcloud projects create

Lưu ý: Nếu bạn không có ý định giữ lại các tài nguyên mà bạn tạo trong một bài tập học tập, hãy tạo một dự án thay vì chọn một dự án hiện có. Sau khi hoàn tất bài tập, bạn có thể xoá dự án để loại bỏ tất cả tài nguyên liên kết với dự án đó.

Bước 2

Để sử dụng Nền tảng Google Maps, bạn phải bật các API hoặc SDK mà bạn dự định sử 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 không chắc nên bật API hoặc SDK nào, hãy thử dùng API Picker hoặc tham khảo tài liệu về API/SDK mà bạn muốn 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 chuyển đến trang Thư viện API Maps trong Cloud Console:

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

2. Nhấp vào API hoặc SDK 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 này để bật API hoặc SDK.
   • Nếu nút này có nội dung QUẢN LÝ, tức là 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 một trong hai 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 đây bật tất cả cá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, quy trình cài đặt Cloud SDK và các lệnh sau:

• gcloud services enable
• gcloud services disable

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"

Lưu ý: Việc bật Places API cũng sẽ bật Thư viện địa điểm, Maps JavaScript API, Places SDK cho Android và Places SDK cho iOS.

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 quá trình phát hành chính thức, 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 duy nhất 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 được 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 Nền tảng Google Maps > Thông tin đăng nhập.

   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 Khoá API đã tạo sẽ hiển thị khoá API mới 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.
   (Hãy nhớ hạn chế API trước khi sử dụng khoá này trong quá trình phát hành công khai.)

SDK đám mây

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

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

• gcloud services api-keys create

Để bật SDK này, hãy xem trang SDK Maps 3D dành cho iOS trong bảng điều khiển Google 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 Nền tảng Google Maps.

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 một dự án Xcode để sử dụng với Maps 3D SDK 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 bắt buộc

Để tạo một dự án bằng Maps 3D SDK 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 Maps 3D SDK 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 dự án 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 Enter để kéo gói vào và nhấp vào "Add Package" (Thêm gói).
• Trong cửa sổ 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 được 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 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) 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.

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)
     }
   }
       

Khoá API có thể xuất hiện ở điểm truy cập của ứng dụng hoặc riêng biệt cho từng chế độ xem bản đồ. Tuy nhiên, nếu bạn chỉ định khoá API ở cả điểm truy cập và chế độ xem bản đồ, thì bảng điều khiển sẽ tạo ra lỗi.

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

Lưu ý: Thông tin sau đây có liên quan khi bạn triển khai ứng dụng của mình lên cửa hàng trực tuyến.

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 Tuyên bố 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 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ữ ứng dụng rồi 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 Google Cloud, khoá API và dự án Xcode để 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.