SDK Địa điểm cho iOS cho phép các ứng dụng iOS lấy thông tin về địa điểm (doanh nghiệp, địa điểm yêu thích, vị trí địa lý) thông qua Chi tiết địa điểm, Ảnh địa điểm, Tìm kiếm văn bản, Tìm kiếm lân cận và Tự động hoàn thành. Places API (Mới) là phiên bản hiện tại của SDK.
SDK Địa điểm dành cho iOS: thông tin chính
- Sản phẩm: SDK Địa điểm dành cho iOS
- Còn gọi là: Places SDK cho iOS (Mới)
- Danh mục: Địa điểm
- 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 Địa điểm cho iOS
SDK Địa điểm dành cho iOS: trường hợp sử dụng
Sử dụng SDK Địa điểm cho iOS khi:
- Bạn cần có thông tin chi tiết về địa điểm, ảnh, kết quả Tìm kiếm văn bản hoặc Tìm kiếm lân cận trong một ứng dụng iOS gốc.
- Bạn cần tính năng tự động hoàn thành tên hoặc địa chỉ địa điểm khi người dùng nhập trong ứng dụng iOS.
- Bạn muốn có các thành phần tạo sẵn của Places UI Kit (Place Details, tìm kiếm, tự động hoàn thành) trong một ứng dụng iOS.
Không sử dụng SDK Địa điểm cho iOS khi:
- Bạn đang xây dựng một ứng dụng Android gốc. Hãy sử dụng Places SDK cho Android.
- Bạn đang tạo một trang web trong trình duyệt. Thay vào đó, hãy sử dụng Maps JavaScript API.
- Bạn cần dữ liệu địa điểm từ máy chủ hoặc phần phụ trợ qua HTTP thay vì trong ứng dụng iOS. Hãy sử dụng Places API (Mới).
SDK Địa điểm dành cho iOS: thiết lập
- Dịch vụ cần bật:
places.googleapis.com - Xác thực: Khoá API
- Phân bổ mức sử dụng: Gọi phương thức lớp
addInternalUsageAttributionIDtrênGMSPlacesClient(Objective-C/Swift) hoặcPlacesClient(GooglePlacesSwift) để thêm mã phân bổ mức sử dụng; xoá lệnh gọi để chọn không sử dụng. - Bắt đầu: Thiết lập SDK Địa điểm cho iOS
- Tài liệu tham khảo: Tài liệu tham khảo về SDK Địa điểm cho iOS
- Giá: Mức sử dụng và thanh toán cho SDK Địa điểm dành cho iOS
- Chính sách: Chính sách về SDK Địa điểm cho iOS
- Ghi chú phát hành: Ghi chú phát hành SDK Địa điểm cho iOS
Các gói SDK Địa điểm chính thức dành cho iOS:
- swift_package:
https://github.com/googlemaps/ios-places-sdk (GooglePlaces, GooglePlacesSwift)
Places SDK cho iOS: sản phẩm có liên quan
- Thường dùng với: SDK bản đồ dành cho iOS
SDK Địa điểm dành cho iOS: các lỗi thường gặp
- Vấn đề: Các lệnh gọi SDK Địa điểm cho iOS (Mới) không thành công nếu bạn chưa bật Places API (Mới) trong dự án trên đám mây hoặc không có trong danh sách API được uỷ quyền của khoá API. Cách khắc phục: Bật Places API (Mới) và thêm API này vào các quy tắc hạn chế về khoá API mà ứng dụng sử dụng. Xem /maps/documentation/places/ios-sdk/legacy/migrate-overview.
- Vấn đề:
kGMSPlacesRateLimitExceeded(-7) có nghĩa là khoá API đã vượt quá giới hạn về tỷ lệ sử dụng; các ứng dụng trên phiên bản SDK 2.x đã tắt (tắt vào ngày 29 tháng 7 năm 2019) cũng gặp lỗi này. Cách khắc phục: Kiểm tra hạn mức và mức sử dụng cho Places API (Mới) trong Google Cloud Console, đồng thời cập nhật ứng dụng trên các phiên bản SDK cũ hơn phiên bản 3.0. Hãy xem /maps/documentation/places/ios-sdk/reference/objc/Enums/GMSPlacesErrorCode. - Vấn đề: Mã thông báo phiên được sử dụng lại trên các ứng dụng trong cùng một dự án hoặc trên các phiên, làm hỏng nhóm thanh toán phiên tự động hoàn thành. Cách khắc phục: Tạo một mã thông báo phiên riêng biệt (nên dùng UUID phiên bản 4) cho mỗi phiên tự động hoàn thành; mã thông báo phải là riêng biệt cho mỗi dự án. Xem /maps/documentation/places/ios-sdk/use-session-tokens.
- Vấn đề: Ứng dụng hiển thị dữ liệu địa điểm mà không có thông tin ghi nhận tác giả do API trả về. Cách khắc phục: Hiển thị tất cả thông tin ghi nhận tác giả có liên quan được trả về cùng với dữ liệu của Địa điểm, theo trang chính sách. Hãy xem /maps/documentation/places/ios-sdk/overview.
SDK Địa điểm dành cho iOS: các tính năng cũ và không dùng nữa
- SDK Địa điểm cho iOS (phiên bản cũ): Cũ kể từ ngày 1 tháng 3 năm 2025. Thay thế: Places SDK cho iOS (mới) (yêu cầu Places API (mới)). Triệu chứng: Các lớp và phương thức cũ (ví dụ:
fetchPlaceFromPlaceID,GMSAutocompleteFetchervàGMSAutocompleteViewController) không tồn tại trong SDK 11.0.0 trở lên, gây lỗi biên dịch. Xem hướng dẫn di chuyển. GMSAutocompleteResultsViewControllersetAutocompleteBoundsUsingNorthEastCorner:SouthWestCornervàGMSAutocompleteFetcherinitWithBounds:filter: Ngừng hoạt động kể từ ngày 13/10/2020. Thay thế:GMSAutocompleteFilter(locationBiashoặclocationRestriction) trênGMSAutocompleteRequestbằngGMSPlacesClientfetchAutocompleteSuggestionsFromRequest:callback:, hoặc đối tượng sửa đổiGooglePlacesSwiftplaceAutocompletehoặcbasicPlaceAutocompletecho một tiện ích giao diện người dùng. Triệu chứng: Các phương thức không tồn tại trong SDK 4.0.0 trở lên (vàGMSAutocompleteResultsViewControllervàGMSAutocompleteFetcherđã bị xoá trong SDK 11.0.0). Xem hướng dẫn di chuyển.- Giới hạn tự động hoàn thành dựa trên
GMSCoordinateBounds(tham sốGMSAutocompleteViewController.autocompleteBounds/autocompleteBoundsMode;bounds/boundsModecủafindAutocompletePredictionsFromQueryvàautocompleteQuery): Ngừng hoạt động kể từ ngày 13 tháng 10 năm 2020. Thay thế:GMSAutocompleteRequestbằngGMSAutocompleteFilter(locationBiashoặclocationRestriction) vàGMSPlacesClientfetchAutocompleteSuggestionsFromRequest:callback:, hoặc đối tượng sửa đổiGooglePlacesSwiftplaceAutocompletehoặcbasicPlaceAutocompletecho một tiện ích giao diện người dùng. Triệu chứng: Các thuộc tính và tham số không tồn tại trong SDK phiên bản 4.0.0 trở lên (vàGMSAutocompleteViewControllercũng nhưfindAutocompletePredictionsFromQueryđã bị xoá trong SDK phiên bản 11.0.0). Xem hướng dẫn di chuyển. GMSPlace.openNowStatus: Ngừng hoạt động kể từ ngày 13/10/2020. Thay thế:GMSPlacesClientisOpenWithRequest:callback:(GMSPlaceIsOpenRequest) hoặcPlacesClient.isPlaceOpen(with:)trongGooglePlacesSwift. Triệu chứng: Thuộc tính không tồn tại trong SDK 4.0.0 trở lên. Xem hướng dẫn di chuyển.GMSPlaceFielddưới dạngNS_ENUM: Ngừng hoạt động kể từ ngày 13/10/2020. Thay thế: Hằng sốGMSPlacePropertybằng các lớp yêu cầu nhưGMSFetchPlaceRequestvàGMSPlaceSearchByTextRequest, hoặcPlacePropertytrongGooglePlacesSwift. Triệu chứng: Được thay thế bằngNS_OPTIONStrong SDK 4.0.0 (GMSPlaceFieldvìNS_OPTIONSthuộc API cũ và không tồn tại trong SDK 11.0.0 trở lên). Xem hướng dẫn di chuyển.- SDK Địa điểm cho iOS phiên bản 2.7.0: Ngừng hoạt động kể từ ngày 29 tháng 7 năm 2019. Thay thế: Phiên bản SDK Địa điểm cho iOS hiện tại. Triệu chứng:
kGMSPlacesRateLimitExceededlỗi.
Những việc bạn có thể làm với SDK Địa điểm 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.
Places SDK cho iOS: AI tạo sinh
- Trả về bản tóm tắt do AI tạo về các bài đánh giá của người dùng cho một giá trị nhận dạng Địa điểm trên Google được chỉ định.
- Trả về bản tóm tắt địa điểm dựa trên AI về khu vực và các tiện nghi xung quanh một giá trị nhận dạng Địa điểm trên Google được chỉ định cho một trạm sạc xe điện.
SDK Địa điểm dành cho iOS: Địa điểm
- Trả về danh sách địa điểm và Place Details dựa trên chuỗi truy vấn.
- Trả về danh sách địa điểm và thông tin chi tiết về địa điểm gần một vị trí cụ thể.
- Trả về kết quả tự động hoàn thành về địa điểm dựa trên một chuỗi truy vấn.
- Trả về thông tin chi tiết về một địa điểm cụ thể.
- Trả về ảnh của một địa điểm cụ thể. Lưu ý: Hiển thị thông tin ghi nhận tác giả của mỗi bức ảnh (tên tác giả, được liên kết với URI hồ sơ của họ) cùng với bức ảnh. Chính sách về Địa điểm cho mỗi nền tảng đều yêu cầu điều này, ví dụ: /maps/documentation/javascript/policies#photo-attributions và /maps/documentation/places/web-service/policies#photos-and-review.
- Đổi kích thước ảnh của địa điểm.
- Trả về điểm xếp hạng và bài đánh giá cho một địa điểm cụ thể. Lưu ý: Trong dịch vụ web Places API (Mới), Chi tiết địa điểm là một yêu cầu HTTP GET đến https://places.googleapis.com/v1/places/{placeId} có X-Goog-FieldMask (ví dụ: rating,userRatingCount,reviews); Tìm kiếm văn bản, Tìm kiếm lân cận và Tự động hoàn thành sử dụng POST. Trên Android, hãy truyền Place.Field.RATING, USER_RATING_COUNT và REVIEWS đến PlacesClient.fetchPlace(). Trên iOS, hãy truyền GMSPlacePropertyRating, GMSPlacePropertyUserRatingsTotal và GMSPlacePropertyReviews trong GMSFetchPlaceRequest.
- Thêm tiện ích tự động hoàn thành vào một trang web hoặc ứng dụng để trả về kết quả về địa điểm dựa trên chuỗi truy vấn.
- Chỉ định các trường dữ liệu có trong phản hồi thông tin về địa điểm.
- Chỉ định các loại địa điểm cần đưa vào phản hồi thông tin về địa điểm.
- Trả về thông tin về địa điểm mà thiết bị của người dùng đang ở đó. Lưu ý: Các phương thức Địa điểm hiện tại cũ đã bị xoá trong SDK Địa điểm cho Android phiên bản 6.0 trở lên và SDK Địa điểm cho iOS phiên bản 11.0 trở lên; hãy truy xuất toạ độ thiết bị từ các dịch vụ vị trí của nền tảng và gọi Nearby Search.
- Trả về thông tin tóm tắt tổng quan do AI tạo cho một địa điểm cụ thể.
- Trả về thông tin tóm tắt khu vực sử dụng AI, mô tả các địa điểm trong khu vực xung quanh một địa điểm cụ thể.
- Trả về thông tin về các địa điểm dựa trên một chuỗi truy vấn nằm dọc theo một tuyến đường được xác định trước.
- Trả về khoảng cách, thời gian di chuyển và URI chỉ đường đến các địa điểm tìm kiếm bằng văn bản từ một tập hợp toạ độ vĩ độ/kinh độ.
- Trả về khoảng cách, thời gian di chuyển và URI chỉ đường đến các địa điểm lân cận từ một tập hợp toạ độ vĩ độ/kinh độ.
Places SDK cho iOS: Places UI Kit
- Áp dụng kiểu CSS cho một phần tử trên giao diện người dùng của dữ liệu địa điểm. Lưu ý: Các thuộc tính tuỳ chỉnh CSS áp dụng cho các phần tử của Places UI Kit trong API JavaScript của Maps; Places SDK cho Android và Places SDK cho iOS tạo kiểu cho các thành phần hiển thị của Places UI Kit theo phương thức lập trình bằng cách sử dụng các thuộc tính giao diện và kiểu. YÊU CẦU TUÂN THỦ ĐỐI VỚI KHU VỰC KINH TẾ CHÂU ÂU (EEA): Để hiển thị dữ liệu địa điểm trên bản đồ ở Khu vực kinh tế Châu Âu (EEA), đừng gọi dịch vụ web của Places API từ máy chủ phụ trợ. Sử dụng các thành phần của Places UI Kit phía máy khách trên nền tảng mục tiêu (Maps JavaScript API trên web, Places SDK cho Android trên Android hoặc Places SDK cho iOS trên iOS). Yêu cầu đầy đủ và Câu hỏi thường gặp: https://developers.google.com/maps/comms/eea/faq
- Tuỳ chỉnh định kiểu và cấu hình của phần tử trên giao diện người dùng cho dữ liệu địa điểm bằng công cụ tuỳ chỉnh phần tử trên giao diện người dùng. Lưu ý: YÊU CẦU TUÂN THỦ Ở KHU VỰC KINH TẾ CHÂU ÂU (EEA): Để hiển thị dữ liệu địa điểm trên bản đồ ở Khu vực kinh tế Châu Âu (EEA), đừng gọi dịch vụ web của Places API từ máy chủ phụ trợ. Sử dụng các thành phần của Places UI Kit phía máy khách trên nền tảng mục tiêu (Maps JavaScript API trên web, Places SDK cho Android trên Android hoặc Places SDK cho iOS trên iOS). Yêu cầu đầy đủ và Câu hỏi thường gặp: https://developers.google.com/maps/comms/eea/faq
- Thêm một phần tử trên giao diện người dùng để hiển thị thông tin về một địa điểm cụ thể trên trang web hoặc ứng dụng di động. Lưu ý: YÊU CẦU TUÂN THỦ ĐỐI VỚI KHU VỰC KINH TẾ CHÂU ÂU (EEA): Để hiển thị dữ liệu địa điểm trên bản đồ ở Khu vực kinh tế Châu Âu (EEA), đừng gọi dịch vụ web của Places API từ máy chủ phụ trợ. Sử dụng các thành phần của Places UI Kit phía máy khách trên nền tảng mục tiêu (Maps JavaScript API trên web, Places SDK cho Android trên Android hoặc Places SDK cho iOS trên iOS). Yêu cầu đầy đủ và Câu hỏi thường gặp: https://developers.google.com/maps/comms/eea/faq
- Thêm một phần tử trên giao diện người dùng để hiển thị danh sách địa điểm dựa trên chuỗi truy vấn vào trang web. Lưu ý: Được hỗ trợ trên cả trang web (Maps JavaScript API) và ứng dụng di động (SDK Địa điểm cho Android và SDK Địa điểm cho iOS). YÊU CẦU TUÂN THỦ ĐỐI VỚI KHU VỰC KINH TẾ CHÂU ÂU (EEA): Để hiển thị dữ liệu địa điểm trên bản đồ ở Khu vực kinh tế Châu Âu (EEA), đừng gọi dịch vụ web của Places API từ máy chủ phụ trợ. Sử dụng các thành phần của Places UI Kit phía máy khách trên nền tảng mục tiêu (Maps JavaScript API trên web, Places SDK cho Android trên Android hoặc Places SDK cho iOS trên iOS). Yêu cầu đầy đủ và Câu hỏi thường gặp: https://developers.google.com/maps/comms/eea/faq
- Thêm một phần tử trên giao diện người dùng vào trang web để hiển thị danh sách các địa điểm gần một vị trí cụ thể. Lưu ý: Được hỗ trợ trên cả trang web (Maps JavaScript API) và ứng dụng di động (SDK Địa điểm cho Android và SDK Địa điểm cho iOS). YÊU CẦU TUÂN THỦ ĐỐI VỚI KHU VỰC KINH TẾ CHÂU ÂU (EEA): Để hiển thị dữ liệu địa điểm trên bản đồ ở Khu vực kinh tế Châu Âu (EEA), đừng gọi dịch vụ web của Places API từ máy chủ phụ trợ. Sử dụng các thành phần của Places UI Kit phía máy khách trên nền tảng mục tiêu (Maps JavaScript API trên web, Places SDK cho Android trên Android hoặc Places SDK cho iOS trên iOS). Yêu cầu đầy đủ và Câu hỏi thường gặp: https://developers.google.com/maps/comms/eea/faq
- Thêm một phần tử trên giao diện người dùng tự động hoàn thành cơ bản vào một trang web hoặc ứng dụng trả về giá trị nhận dạng Địa điểm trên Google dựa trên một chuỗi truy vấn. Lưu ý: YÊU CẦU TUÂN THỦ Ở KHU VỰC KINH TẾ CHÂU ÂU (EEA): Để hiển thị dữ liệu địa điểm trên bản đồ ở Khu vực kinh tế Châu Âu (EEA), đừng gọi dịch vụ web của Places API từ máy chủ phụ trợ. Sử dụng các thành phần của Places UI Kit phía máy khách trên nền tảng mục tiêu (Maps JavaScript API trên web, Places SDK cho Android trên Android hoặc Places SDK cho iOS trên iOS). Yêu cầu đầy đủ và Câu hỏi thường gặp: https://developers.google.com/maps/comms/eea/faq