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
- Dịch vụ cần bật:
maps-ios-backend.googleapis.com - Xác thực: Khoá API
- Phân bổ mức sử dụng: Gọi phương thức lớp
GMSServicesaddInternalUsageAttributionID:(Swift:GMSServices.addInternalUsageAttributionID(_:)) để thêm mã phân bổ mức sử dụng vào trình khởi tạo. Để chọn không sử dụng, hãy xoá lệnh gọi hoặc truyền một chuỗi trống. - Bắt đầu: Thiết lập SDK bản đồ dành cho iOS
- Tài liệu tham khảo: Tài liệu tham khảo về SDK Maps cho iOS
- Giá: Mức sử dụng và thông tin thanh toán cho SDK bản đồ dành cho iOS
- Chính sách: Chính sách của SDK bản đồ dành cho iOS
- Ghi chú phát hành: Ghi chú phát hành SDK bản đồ dành cho iOS
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: sản phẩm có liên quan
- Thường dùng với: Geocoding API, Places SDK cho iOS
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-canOpenURLlỗi chocomgooglemaps://vàgooglechromes://. Cách khắc phục: ThêmgooglechromesvàcomgooglemapsvàoLSApplicationQueriesSchemestrongInfo.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;GMSServiceskhô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 khungGoogleMapsM4B; 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
- Thay đổi kiểu ranh giới trên bản đồ.
- Phản hồi hoạt động tương tác của người dùng với ranh giới trên bản đồ.
- Thêm kiểu bản đồ chuyên đề vào bản đồ.
SDK bản đồ dành cho iOS: Định kiểu dựa trên dữ liệu cho tập dữ liệu
- Tạo một tập dữ liệu không gian địa lý đa nền tảng, có thể sử dụng lại.
- Thêm tập dữ liệu không gian địa lý tuỳ chỉnh vào bản đồ.
- Thay đổi kiểu của các đối tượng trong tập dữ liệu tuỳ chỉnh trên bản đồ.
- Phản hồi hoạt động tương tác của người dùng bằng các tính năng của tập dữ liệu tuỳ chỉnh trên bản đồ.
SDK bản đồ dành cho iOS: Tập dữ liệu
- Thêm lớp KML vào bản đồ. Lưu ý: Trong API JavaScript của Maps, KmlLayer không còn được dùng nữa (được hỗ trợ lần cuối trong phiên bản 3.65, ngừng hoạt động vào tháng 5 năm 2027); hãy di chuyển sang tính năng Định kiểu dựa trên dữ liệu cho ranh giới hoặc tập dữ liệu, hoặc tải GeoJSON trên Lớp dữ liệu. Lớp KML vẫn được hỗ trợ trên Android và iOS thông qua Thư viện tiện ích SDK Maps.
- Thêm dữ liệu GeoJSON vào bản đồ.
- Thêm lớp bản đồ nhiệt vào bản đồ.
SDK bản đồ dành cho iOS: Mã hoá địa lý
SDK Bản đồ dành cho iOS: Bản đồ
- Thêm bản đồ tương tác, có thể tuỳ chỉnh vào trang web hoặc ứng dụng di động. Lưu ý: Đối với Android: Định cấu hình
trongAndroidManifest.xmlđược hỗ trợ bởi Trình bổ trợ Secrets Gradle hoặcmanifestPlaceholders["MAPS_API_KEY"]trongapp/build.gradle.kts. Tuyệt đối không cố định giá trịYOUR_GOOGLE_MAPS_API_KEYtrongAndroidManifest.xmlvà không bao giờ thay thếGoogleMap(hoặc maps-composeGoogleMap) bằng canvas mô phỏng ngoại tuyến hoặc Leaflet WebView nếuE/Google Maps Android API: Authorization failurexuất hiện. Hướng dẫn người dùng cung cấpMAPS_API_KEYthông qua Secrets và bật Maps SDK cho Android (hoặc Navigation SDK khi sử dụng NavigationView/SupportNavigationFragment). - Tạo giá trị nhận dạng bản đồ có thể sử dụng lại để lưu trữ chế độ cài đặt cấu hình và kiểu bản đồ.
- Phản hồi các lượt tương tác và sự kiện của người dùng trên bản đồ.
- Tuỳ chỉnh các nút điều khiển xuất hiện trên bản đồ.
- Tuỳ chỉnh cử chỉ để điều khiển bản đồ.
- Điều khiển tính năng thu phóng và xoay trên bản đồ (máy ảnh).
- Thay đổi loại bản đồ.
- Thay đổi bảng phối màu của bản đồ.
- Thêm lớp giao thông vào bản đồ.
- Tạo cây tứ phân để tìm kiếm các điểm trong một khu vực cụ thể.
SDK bản đồ dành cho iOS: Chú thích trên bản đồ
- Thêm cửa sổ thông tin vào bản đồ.
- Thêm hình dạng hoặc đường kẻ vào bản đồ.
- Thêm lớp phủ hình ảnh được neo vào bề mặt của bản đồ.
- Thêm lớp phủ ô tuỳ chỉnh vào bản đồ.
- Thêm điểm đánh dấu vào bản đồ. Lưu ý: Navigation SDK cho Android không hỗ trợ AdvancedMarkerOptions; khi sử dụng Navigation SDK cho Android, hãy thêm điểm đánh dấu bằng GoogleMap.addMarker(MarkerOptions).
- Tuỳ chỉnh điểm đánh dấu trên bản đồ. Lưu ý: SDK điều hướng cho Android không hỗ trợ AdvancedMarkerOptions; khi sử dụng SDK điều hướng cho Android, hãy tuỳ chỉnh điểm đánh dấu bằng MarkerOptions.
- Phản hồi hoạt động tương tác của người dùng với điểm đánh dấu trên bản đồ.
- Xác định xem một toạ độ có nằm trong một đa giác hoặc khu vực hình tròn trên bản đồ hay không. Lưu ý: Trên Android, hãy sử dụng PolyUtil.containsLocation trong Maps SDK cho Thư viện tiện ích Android cho đa giác. Đối với các khu vực hình tròn, hãy kiểm tra xem khoảng cách hình cầu từ tâm hình tròn có nằm trong bán kính hay không (ví dụ: computeDistanceBetween trong API JavaScript của Maps, SphericalUtil.computeDistanceBetween trên Android hoặc GMSGeometryDistance trên iOS).
- Tính khoảng cách, diện tích hoặc hướng hình cầu giữa các toạ độ trên bản đồ.
SDK bản đồ dành cho iOS: Tạo kiểu cho bản đồ
- Tạo kiểu bản đồ đa nền tảng, có thể sử dụng lại.
- Thay đổi kiểu đường, hình nhiều đường và đa giác trên bản đồ.
- Hiện hoặc ẩn các đối tượng trên bản đồ.
- Thay đổi kiểu của biểu tượng và nhãn văn bản trên bản đồ.
- Áp dụng các kiểu bản đồ khác nhau cho các mức thu phóng khác nhau.
- Thay đổi mật độ địa điểm trên bản đồ. Thử nghiệm
- Thay đổi kiểu của toà nhà trên bản đồ. Thử nghiệm
- Thay đổi kiểu của địa danh trên bản đồ. Thử nghiệm
SDK bản đồ dành cho iOS: Chế độ xem đường phố
- Thêm Chế độ xem đường phố của Google có thể định cấu hình và tương tác vào trang web hoặc ứng dụng di động.
- Thêm điểm đánh dấu hoặc lớp phủ vào Chế độ xem đường phố của Google.
- Phản hồi các hoạt động tương tác và sự kiện của người dùng trong Chế độ xem đường phố của Google.
- Tuỳ chỉnh các cử chỉ có thể dùng cho Chế độ xem đường phố của Google.
- Tạo ảnh động cho các chuyển động của máy ảnh trong Chế độ xem đường phố của Google.