Chọn phiên bản SDK của bạn

Các tính năng SDK Địa điểm dành cho iOS có trong ứng dụng được xác định bằng tổ hợp số phiên bản SDK (ví dụ: 9.0.0) mà mà bạn chỉ định trong các phần phụ thuộc của gói và các API được bật trên khoá API. Hướng dẫn này giải thích sự khác biệt giữa các phiên bản và cách chọn được bật trong ứng dụng của bạn.

Số phiên bản SDK

Số phiên bản của SDK mà bạn chỉ định trong các phần phụ thuộc của gói giúp xác định xem ứng dụng của bạn có quyền truy cập vào các tính năng đã được thêm vào trong bản phát hành cụ thể. Ví dụ: tính năng Tự động hoàn thành (Mới) chỉ có trong SDK phiên bản 9.0.0 trở lên.

Để biết thêm thông tin về những thay đổi được giới thiệu trong mỗi phiên bản SDK, hãy xem phần Địa điểm Ghi chú phát hành SDK dành cho iOS.

Phiên bản API Địa điểm cho Places SDK dành cho iOS

Ngoài việc chỉ định số phiên bản SDK, bạn cũng phải chọn Địa điểm Dịch vụ API mà SDK gọi trong Google Cloud Console: API Địa điểm hoặc Places API (Mới). Cùng với số phiên bản SDK, dịch vụ API mà bạn chọn sẽ xác định phiên bản của các tính năng cụ thể có sẵn trong ứng dụng của bạn, chẳng hạn như Tự động hoàn thành hoặc Tự động hoàn thành (Mới). Mặc dù bạn chỉ có thể chỉ định một SDK số phiên bản, bạn có thể bật cả Places API và Places API (Mới) trên khoá API cùng một lúc. Tuy nhiên, trong hầu hết các trường hợp, bạn cần bật Places API (Mới) và sử dụng phiên bản (Mới) của các tính năng SDK trong ứng dụng.

Chọn phiên bản SDK và dịch vụ API

Để chọn tính năng SDK nào có trong ứng dụng của bạn, hãy làm như sau:

  1. Trong dự án Google Cloud, hãy bật Places API, Places API (Mới) hoặc cả hai. Để biết thêm thông tin, hãy xem phần Bật API
  2. Trong các quy định hạn chế đối với khoá API, hãy bật Places API, Places API (Mới) hoặc cả hai. Để biết thêm thông tin, hãy xem phần Hạn chế API khoá.
  3. Khi bạn cài đặt SDK, hãy chỉ định số phiên bản. Để biết thêm thông tin, hãy xem Thiết lập dự án Xcode.

Để biết thêm thông tin về cách chọn dịch vụ API Địa điểm, hãy xem phần Thiết lập Dự án trên Google Cloud.

Các tính năng SDK có trong từng phiên bản

Bảng sau đây trình bày những phiên bản SDK và API bắt buộc cho từng SDK tính năng:

Tính năng Đã bật API địa điểm trên khoá API Phiên bản SDK tối thiểu
Tự động hoàn thành (Mới) Places API (Mới) 9.0.0
Thông tin chi tiết về địa điểm (Mới) Places API (Mới) 9.0.0
Tìm kiếm lân cận (Mới) Places API (Mới) 9.0.0
Ảnh về địa điểm (Mới) Places API (Mới) 9.0.0
Tìm kiếm văn bản (Mới) Places API (Mới) 8.5.0
Tự động hoàn thành địa điểm Places API 3.0.0
Địa điểm hiện tại Places API 3.0.0
Thông tin chi tiết về địa điểm Places API 3.0.0
Hình ảnh địa điểm Places API 3.0.0

Những điều cần cân nhắc khi chọn phiên bản cần bật

  • Nếu bạn là khách hàng mới chỉ mới bắt đầu sử dụng SDK Địa điểm dành cho iOS, khi đó bắt đầu với Places API (Mới) và SDK mới.
  • Nếu đang là khách hàng, bạn có thể tiếp tục sử dụng SDK hiện có. Tuy nhiên, để tận dụng những điểm cải tiến về hiệu suất và tính năng các tính năng nâng cao của Places SDK dành cho iOS (Mới), bạn nên bật Places API (Mới) và sử dụng SDK mới. Không cần phải di chuyển khi chuyển sang SDK mới, chỉ cần làm theo các bước trong bài viết Chọn phiên bản SDK và API của bạn luôn miễn phí.
  • Places API (Mới) không cho phép một số Places API hiện có như Current Địa điểm, GMSPlace.isOpenGMSPlaceisOpenAtDate.

Sử dụng Bản xem trước của GooglePlacesSwift

Bạn cần phải thực hiện các bước sau để sử dụng GooglePlacesSwift:

  1. Bật API Địa điểm (Mới).
  2. Thêm GooglePlacesSwiftSDK cho các phần phụ thuộc.
  3. Khởi chạy ứng dụng Địa điểm bằng PlacesClient.

Để tìm hiểu thêm về GooglePlacesSwift, hãy xem lại tài liệu tham khảo .

Di chuyển sang API mới

Nếu bạn đang sử dụng một API hiện có và muốn chuyển sang API mới, hãy xem sau đây là hướng dẫn di chuyển cho từng API:

Các tính năng nâng cao trong Places SDK dành cho iOS (Mới)

Phần này đề cập đến các tính năng chính được thêm vào SDK Địa điểm dành cho iOS (Mới).

Được triển khai trên nền tảng tiêu chuẩn Google Cloud

SDK Địa điểm dành cho iOS (Mới) được triển khai trên dịch vụ cơ sở hạ tầng trên Google Cloud. Cách triển khai này mang đến một nền tảng an toàn và đáng tin cậy hơn. Thiết kế tiêu chuẩn này mang lại mức độ nhất quán giữa các SDK giúp cải thiện hiệu quả phát triển với Places SDK dành cho iOS (Mới).

Cải tiến hiệu suất

SDK Địa điểm dành cho iOS (Mới) cải thiện hiệu suất, giúp bạn nên thay thế các ứng dụng dùng SDK hiện có.

Tính năng mới

SDK Địa điểm dành cho iOS (Mới) bao gồm các phiên bản mới nhất của tất cả tính năng của SDK:

Định giá đơn giản

Việc đặt giá được đơn giản hoá với SDK Địa điểm dành cho iOS (Mới) để bạn chỉ trả tiền cho dữ liệu mình sử dụng. Phương thức định giá đơn giản được triển khai bằng cách sử dụng trường danh sách này, còn được gọi là fieldMask (mặt nạ trường).

Với SDK Địa điểm dành cho iOS và Tìm kiếm văn bản bạn sử dụng danh sách trường để kiểm soát danh sách cần trả về trong phản hồi. Sau đó, bạn sẽ chỉ phải thanh toán cho dữ liệu đã yêu cầu. Sử dụng danh sách trường là một phương pháp thiết kế hiệu quả để đảm bảo rằng bạn không yêu cầu dữ liệu không cần thiết, giúp tránh thời gian xử lý không cần thiết và các khoản phí thanh toán.

Để biết thông tin chi tiết về giá cho cả hai SDK, hãy xem phần Cách sử dụng và Thanh toán.

Loại địa điểm mở rộng

SDK mới sẽ thêm các loại địa điểm như trong bảng sau. Những loại này được trả lại như một phần của Chi tiết địa điểm và Câu trả lời trên tính năng Tìm kiếm văn bản. Bạn cũng có thể sử dụng các loại mới này, và các loại hiện có, trong tìm kiếm bằng Tìm kiếm văn bản. Các loại mới được bao gồm trong Bảng Đáp:.

Loại
american_restaurant discount_store ice_cream_shop sandwich_shop
amusement_center dog_park indian_restaurant school_district
athletic_field electric_vehicle_charging_station indonesian_restaurant seafood_restaurant
auto_parts_store event_venue italian_restaurant ski_resort
banquet_hall extended_stay_hotel japanese_restaurant spanish_restaurant
barbecue_restaurant trang trại korean_restaurant sporting_goods_store
barber_shop lưu trú ở trang trại lebanese_restaurant sports_club
bed_and_breakfast fast_food_restaurant marina sports_complex
brazilian_restaurant ferry_terminal market steak_house
breakfast_restaurant fitness_center medical_lab sushi_restaurant
brunch_restaurant french_restaurant mediterranean_restaurant swimming_pool
bus_stop gift_shop mexican_restaurant thợ may
camping_cabin golf_course middle_eastern_restaurant telecommunications_service_provider
cell_phone_store greek_restaurant khách sạn ven đường cho khách có ô tô thai_restaurant
child_care_agency grocery_store national_park transit_depot
chinese_restaurant guest_house park_and_ride truck_stop
coffee_shop hair_salon performing_arts_theater turkish_restaurant
community_center hamburger_restaurant pizza_restaurant vegan_restaurant
nhà tư vấn sân bay trực thăng sân chơi vegetarian_restaurant
convention_center hiking_area mầm non vietnamese_restaurant
nhà nghỉ ngoại ô historical_landmark private_guest_room visitor_center
courier_service home_improvement_store ramen_restaurant wedding_venue
cultural_center nhà nghỉ resort_hotel nhà bán buôn
dental_clinic hotel rest_stop

Cùng với các loại mới này, Places API (Mới) đã chuyển các loại sau từ Bảng 2 cho Places API đến Bảng A cho Places API (Mới). Điều đó có nghĩa là giờ đây bạn có thể sử dụng các loại này như một phần của tìm kiếm:

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality