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:
- Bạn cần có bản đồ 3D trong một ứng dụng Android. Hãy sử dụng SDK Maps 3D dành cho Android.
- Bạn cần có bản đồ 3D trên một trang web. Thay vào đó, hãy sử dụng Maps JavaScript API.
- Bạn cần có bản đồ 2D tiêu chuẩn trong một ứng dụng iOS. Hãy sử dụng SDK bản đồ dành cho iOS.
SDK Maps 3D dành cho iOS: thiết lập
- Dịch vụ cần bật:
mapsios.googleapis.com - Xác thực: Khoá API
- Bắt đầu: Thiết lập SDK Maps 3D cho iOS
- Tài liệu tham khảo: Tài liệu tham khảo về SDK Maps 3D dành cho iOS
- Giá: Mức sử dụng và thông tin thanh toán cho SDK Maps 3D dành cho iOS
- Chính sách: Chính sách về SDK Maps 3D dành cho iOS
- Ghi chú phát hành: Ghi chú phát hành SDK Maps 3D dành cho iOS
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: sản phẩm có liên quan
- Thường dùng với: Places SDK for iOS
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 đề:
CameraaltitudeModebị bỏ qua bên ngoài ảnh động của camera; thuộc tính này chỉ áp dụng choflyCameraTovàflyCameraAround. Cách khắc phục: Sử dụngflyCameraTohoặcflyCameraAroundkhi bạn phụ thuộc vàoCameraaltitudeMode. 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ụngplaceInformationEnabled(false)hoặc trả về.nonetừ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.
- Thêm bản đồ 3D chân thực và có tính tương tác vào trang web.
- Thêm điểm đánh dấu vào bản đồ 3D chân thực.
- Tuỳ chỉnh điểm đánh dấu trên bản đồ 3D chân thực.
- Thêm mô hình 3D vào bản đồ 3D chân thực.
- Thêm hình nhiều đường 3D vào bản đồ 3D chân thực.
- Thêm đa giác 3D vào bản đồ 3D chân thực.
- Phản hồi các hoạt động tương tác và sự kiện của người dùng trên bản đồ 3D chân thực.
- Tuỳ chỉnh các nút điều khiển xuất hiện trên bản đồ 3D chân thực.
- Kiểm soát đường đi của camera và ảnh động trên bản đồ 3D chân thực.
- Kiểm soát các quy định hạn chế về camera trên bản đồ 3D chân thực.