Các tính năng SDK địa điểm dành cho iOS có trong ứng dụng của bạn được xác định bằng tổ hợp số phiên bản SDK (ví dụ: 9.0.0) 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 những phiên bả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 sẽ xác định liệu ứ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 một bản phát hành cụ thể hay không. 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 từng phiên bản SDK, hãy xem ghi chú phát hành SDK địa điểm 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 dịch vụ API địa điểm mà SDK gọi trong Google Cloud Console: API địa điểm hoặc API địa điểm (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ể hiện có trong ứng dụng của bạn, chẳng hạn như tính năng Tự động hoàn thành hoặc Tự động hoàn thành (Mới). Mặc dù chỉ có thể chỉ định một số phiên bản SDK, nhưng 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 API Địa điểm (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 của mình.
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:
- 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 bài viết Bật API
- Trong các 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ế khoá API.
- 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 nội dung Thiết lập dự á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 cần thiết cho từng tính năng SDK:
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 Places SDK dành cho iOS, thì hãy 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 các điểm cải tiến về hiệu suất và 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. Bạn không cần 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à dịch vụ API.
- Places API (Mới) không bật một số tính năng hiện có như Địa điểm hiện tại,
GMSPlace.isOpen
vàGMSPlaceisOpenAtDate
.
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:
- Bật API Địa điểm (Mới).
- Thêm GooglePlacesSwiftSDK vào phần phụ thuộc của bạn.
- Khởi chạy ứng dụng Địa điểm bằng
PlacesClient
.
Để tìm hiểu thêm về GooglePlacesSwift, hãy xem 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 hướng dẫn di chuyển sau đây cho từng API:
- Di chuyển đến Thông tin chi tiết về địa điểm (Mới)
- Di chuyển đến địa điểm chụp ảnh (Mới)
- Di chuyển sang tính năng Tự động hoàn thành (Mới)
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 Places SDK 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 cơ sở hạ tầng dịch vụ 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 trên các SDK, giúp cải thiện hiệu quả phát triển bằng SDK Địa điểm 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, khiến việc thay thế các ứng dụng sử dụng SDK hiện có trở nên đáng giá.
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ả các tính năng SDK:
- Tự động hoàn thành (Mới)
- Thông tin chi tiết về địa điểm (Mới)
- Tìm kiếm lân cận (Mới)
- Ảnh về địa điểm (Mới)
- Tìm kiếm văn bản (Mới)
Định giá đơn giản
Việc đặt giá được đơn giản hoá với Places SDK dành cho iOS (Mới) để bạn chỉ phải trả tiền cho dữ liệu mà bạn sử dụng. Cách đặt giá đơn giản được triển khai bằng cách sử dụng danh sách trường (còn được gọi là 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 trường cần trả về trong phản hồi. Sau đó, bạn sẽ chỉ phải trả phí cho dữ liệu được yêu cầu. Việc 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ý và các khoản phí thanh toán không cần thiết.
Để biết thông tin chi tiết về giá cho cả hai SDK, hãy xem phần Mức 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. Các loại này được trả về như một phần của phản hồi Chi tiết địa điểm và Tìm kiếm văn bản. Bạn cũng có thể sử dụng các kiểu mới này và các kiểu hiện có trong tìm kiếm bằng tính năng Tìm kiếm văn bản. Các loại mới được bao gồm trong Bảng A.
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 | khu chợ | 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 sang Bảng A cho Places API (Mới). Điều đó có nghĩa là bạn hiện có thể sử dụng các kiểu này khi tìm kiếm:
country
administrative_area_level_1
administrative_area_level_2
postal_code
locality