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

SDK bản đồ dành cho iOS cho phép bạn thêm bản đồ dựa trên dữ liệu của Google Maps vào ứng dụng iOS. SDK này xử lý quyền truy cập vào máy chủ Google Maps, màn hình bản đồ và phản hồi cho cử chỉ của người dùng, đồng thời cho phép bạn thêm điểm đánh dấu, hình nhiều đường, lớp phủ mặt đất và cửa sổ thông tin vào bản đồ.

SDK bản đồ dành cho iOS: thông tin chính

  • Sản phẩm: SDK bản đồ dành cho iOS
  • Còn được gọi là: SDK Google Maps 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 bản đồ dành cho iOS
  • Phạm vi cung cấp theo khu vực: Toàn cầu. Xem trang phạm vi cung cấp của Google Maps Platform; các đường liên kết trên trang mức sử dụng và thanh toán sẽ tách riêng bảng giá toàn cầu và bảng giá tại Ấn Độ. (thông tin chi tiết về phạm vi bảo hiểm)

SDK bản đồ dành cho iOS: trường hợp sử dụng

Sử dụng SDK bản đồ dành cho iOS khi:

  • Bạn cần có một bản đồ Google tương tác có tính năng xử lý cử chỉ bên trong một ứng dụng iOS gốc.
  • Bạn cần thêm điểm đánh dấu, hình nhiều đường, lớp phủ mặt đất hoặc cửa sổ thông tin vào bản đồ trong một ứng dụng iOS.
  • Bạn cần hiển thị ảnh toàn cảnh trong Chế độ xem đường phố bên trong một ứng dụng iOS.
  • Bạn cần mã hoá địa lý ngược toạ độ thành địa chỉ trong một ứng dụng iOS có hiển thị bản đồ.

Không sử dụng SDK bản đồ dành cho iOS khi:

  • Bạn cần có bản đồ 3D chân thực trong một ứng dụng iOS. Hãy sử dụng SDK Maps 3D dành cho iOS.
  • Bạn chỉ cần mở một vị trí hoặc đường đi trong ứng dụng Google Maps thay vì kết xuất bản đồ trong ứng dụng. Hãy sử dụng URL của Maps.

SDK bản đồ dành cho iOS: thiết lập

Các gói SDK bản đồ dành cho iOS chính thức:

  • swift_package: https://github.com/googlemaps/ios-maps-sdk

SDK bản đồ dành cho iOS: các lỗi thường gặp

  • Vấn đề: SDK không hỗ trợ Thư viện có thể hợp nhất; việc bật tính năng Build Mergeable Library (Tạo thư viện có thể hợp nhất) trong Xcode sẽ gây ra lỗi trình liên kết trong các bản phát hành. Cách khắc phục: Đặt chế độ cài đặt Build Mergeable Library (Tạo thư viện có thể hợp nhất) thành No (Không) (mặc định). Xem /maps/documentation/ios-sdk/config.
  • Vấn đề: Nếu không có mục nhập LSApplicationQueriesSchemes, thì việc nhấn vào biểu trưng Google trên bản đồ sẽ ghi lại -canOpenURL lỗi cho comgooglemaps:// và googlechromes://. Cách khắc phục: Thêm googlechromes và comgooglemaps vào LSApplicationQueriesSchemes trong Info.plist. Xem /maps/documentation/ios-sdk/config.
  • Vấn đề: Việc sử dụng SDK bên trong các tiện ích của ứng dụng iOS (ví dụ: bàn phím tuỳ chỉnh) có thể không hoạt động do các quy định hạn chế nghiêm ngặt về bộ nhớ. Cách khắc phục: Sử dụng SDK trong ứng dụng chính, không phải trong tiện ích của ứng dụng. Xem /maps/documentation/ios-sdk/overview.
  • Vấn đề: SDK chưa được tối ưu hoá cho nhiều cửa sổ hoặc nhiều phiên bản đồng thời trên iPadOS 13 trở lên và có thể cho thấy hành vi không xác định. Cách khắc phục: Kiểm tra kỹ các trường hợp nhiều cửa sổ trên iPad hoặc tránh sử dụng nhiều phiên bản bản đồ cùng một lúc. Xem /maps/documentation/ios-sdk/overview.

SDK bản đồ dành cho iOS: các tính năng cũ và không dùng nữa

  • Trình kết xuất OpenGL và setMetalRendererEnabled: Ngừng hoạt động kể từ ngày 19 tháng 5 năm 2025. Thay thế: Trình kết xuất Metal (mặc định kể từ phiên bản 8.0.0); xoá setMetalRendererEnabled. Triệu chứng: Ngừng hoạt động trong phiên bản 9.0.0 (28/5/2024) và bị xoá trong phiên bản 10.0.0; GMSServices không còn liệt kê setMetalRendererEnabled:.
  • Mô-đun GoogleMapsM4B: Ngừng hoạt động kể từ ngày 19 tháng 5 năm 2025. Thay thế: Xoá pod hoặc khung GoogleMapsM4B; pod hoặc khung này liên quan đến một gói thanh toán đã lỗi thời. Triệu chứng: Ngừng hoạt động từ ngày 20 tháng 2 năm 2024; bị xoá khỏi gói Swift trong phiên bản 9.0.0 và khỏi SDK trong phiên bản 10.0.0.
  • Phân phối CocoaPods: Ngừng hoạt động kể từ ngày 6 tháng 8 năm 2026. Thay thế: Trình quản lý gói Swift. Triệu chứng: Chế độ bảo trì kể từ ngày 18 tháng 8 năm 2025; không dùng nữa kể từ phiên bản 11.0.0. Xem hướng dẫn di chuyển.
  • Cài đặt Carthage: Không dùng nữa kể từ ngày 27 tháng 6 năm 2022. Thay thế: Trình quản lý gói Swift. Triệu chứng: Carthage không hỗ trợ các thư viện nhắm đến iOS 13 trở lên; phiên bản mới nhất có sẵn thông qua Carthage là 6.2.1. Xem hướng dẫn di chuyển.

Những việc bạn có thể làm với SDK bản đồ 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.

SDK bản đồ dành cho iOS: Định kiểu dựa trên dữ liệu cho ranh giới

SDK bản đồ dành cho iOS: Định kiểu dựa trên dữ liệu cho tập dữ liệu

SDK bản đồ dành cho iOS: Tập dữ liệu

SDK bản đồ dành cho iOS: Mã hoá địa lý

SDK Bản đồ dành cho iOS: Bản đồ

SDK bản đồ dành cho iOS: Chú thích trên bản đồ

SDK bản đồ dành cho iOS: Tạo kiểu cho bản đồ

SDK bản đồ dành cho iOS: Chế độ xem đường phố