Tài liệu tham khảo nhanh về SDK Maps 3D dành cho iOS

Maps 3D SDK dành cho iOS giúp bạn xây dựng trải nghiệm bản đồ 3D trong các ứng dụng iOS bằng hình ảnh 3D của Google. Thư viện này cung cấp các API SwiftUI cho điểm đánh dấu, cửa sổ bật lên, hình nhiều đường, đa giác, mô hình 3D (glTF), ảnh động về đường đi của camera, cũng như các chế độ điều khiển camera và tương tác.

SDK Maps 3D dành cho iOS: thông tin chính

  • Sản phẩm: SDK Maps 3D dành cho iOS
  • Danh mục: Maps
  • Nền tảng: iOS
  • Chạy trên: Ứng dụng khách (mã ứng dụng hoặc trình duyệt)
  • Giai đoạn ra mắt: GA
  • Vòng đời: Đang hoạt động
  • Tổng quan: Tổng quan về SDK Maps 3D dành cho iOS

SDK Maps 3D dành cho iOS: trường hợp sử dụng

Sử dụng SDK Maps 3D dành cho iOS khi:

  • Bạn cần có một bản đồ 3D chân thực và có tính tương tác trong một ứng dụng iOS gốc (SwiftUI).
  • Bạn cần đặt điểm đánh dấu, cửa sổ bật lên, hình nhiều đường, đa giác hoặc mô hình 3D glTF trên bản đồ 3D trong iOS.
  • Bạn cần có ảnh động camera bay đến hoặc bay xung quanh, hoặc các quy định hạn chế về camera, trên bản đồ 3D trong iOS.
  • Bạn cần người dùng nhấn vào các điểm bản đồ yêu thích trên bản đồ 3D và xem Place Details thông qua tiện ích Places UI Kit tích hợp sẵn.

Không sử dụng SDK Maps 3D dành cho iOS khi:

SDK Maps 3D dành cho iOS: thiết lập

Các gói SDK Maps 3D chính thức dành cho iOS:

  • swift_package: https://github.com/googlemaps/ios-maps-3d-sdk (product GoogleMaps3D)
  • swift_package: https://github.com/googlemaps/ios-maps-3d-sdk (product GoogleMaps3DKit, for POI taps with the Places UI Kit widget)

SDK Maps 3D dành cho iOS: các lỗi thường gặp

  • Vấn đề: Nếu không có chế độ bản đồ nào được đặt khi bản đồ tải, thì bản đồ sẽ không tải được. Cách khắc phục: Luôn truyền một chế độ khi tạo Map, ví dụ: Map(mode: .hybrid). Xem /maps/documentation/maps-3d/ios-sdk/map-modes.
  • Vấn đề: Việc đặt khoá API ở cả điểm truy cập ứng dụng và trên từng chế độ xem bản đồ sẽ gây ra lỗi bảng điều khiển. Cách khắc phục: Chỉ đặt Map.apiKey ở một nơi: điểm truy cập ứng dụng hoặc từng chế độ xem bản đồ. Hãy xem /maps/documentation/maps-3d/ios-sdk/setup.
  • Vấn đề: Camera altitudeMode bị bỏ qua bên ngoài ảnh động của camera; thuộc tính này chỉ áp dụng cho flyCameraTo và flyCameraAround. Cách khắc phục: Sử dụng flyCameraTo hoặc flyCameraAround khi bạn phụ thuộc vào Camera altitudeMode. Xem /maps/documentation/maps-3d/ios-sdk/custom-camera-paths.
  • Vấn đề: Trong GoogleMaps3DKit, tiện ích giao diện người dùng Địa điểm sẽ xuất hiện theo mặc định khi người dùng nhấn vào một địa điểm yêu thích. Cách khắc phục: Sử dụng placeInformationEnabled(false) hoặc trả về .none từ onPlaceTap(_:) để chặn tiện ích. Xem /maps/documentation/maps-3d/ios-sdk/points-of-interest.

Những việc bạn có thể làm với SDK Maps 3D dành cho iOS

Hãy xem hướng dẫn được liên kết bên dưới cho từng nhiệm vụ hoặc so sánh giữa các sản phẩm trong Trình khám phá chức năng.