Tài liệu tham khảo nhanh về SDK Địa điểm dành cho iOS

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

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)

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, GMSAutocompleteFetcher và 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.
  • GMSAutocompleteResultsViewController setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner và GMSAutocompleteFetcher initWithBounds:filter: Ngừng hoạt động kể từ ngày 13/10/2020. Thay thế: GMSAutocompleteFilter (locationBias hoặc locationRestriction) trên GMSAutocompleteRequest bằng GMSPlacesClient fetchAutocompleteSuggestionsFromRequest:callback:, hoặc đối tượng sửa đổi GooglePlacesSwift placeAutocomplete hoặc basicPlaceAutocomplete cho 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à GMSAutocompleteResultsViewController và 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/boundsMode của findAutocompletePredictionsFromQuery và autocompleteQuery): Ngừng hoạt động kể từ ngày 13 tháng 10 năm 2020. Thay thế: GMSAutocompleteRequest bằng GMSAutocompleteFilter (locationBias hoặc locationRestriction) và GMSPlacesClient fetchAutocompleteSuggestionsFromRequest:callback:, hoặc đối tượng sửa đổi GooglePlacesSwift placeAutocomplete hoặc basicPlaceAutocomplete cho 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à GMSAutocompleteViewController cũ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ế: GMSPlacesClient isOpenWithRequest:callback: (GMSPlaceIsOpenRequest) hoặc PlacesClient.isPlaceOpen(with:) trong GooglePlacesSwift. 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.
  • GMSPlaceField dưới dạng NS_ENUM: Ngừng hoạt động kể từ ngày 13/10/2020. Thay thế: Hằng số GMSPlaceProperty bằng các lớp yêu cầu như GMSFetchPlaceRequest và GMSPlaceSearchByTextRequest, hoặc PlaceProperty trong GooglePlacesSwift. Triệu chứng: Được thay thế bằng NS_OPTIONS trong SDK 4.0.0 (GMSPlaceField vì NS_OPTIONS thuộ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: kGMSPlacesRateLimitExceeded lỗ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

SDK Địa điểm dành cho iOS: Địa điểm

Places SDK cho iOS: Places UI Kit