Các tính năng của SDK Địa điểm dành cho iOS có trong ứng dụng được xác định bằng cách kết hợp số phiên bản SDK (ví dụ: 9.0.0) mà bạn chỉ định trong phần phụ thuộc 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 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 phần phụ thuộc gói 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 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ề các thay đổi được đưa ra trong từng phiên bản SDK, hãy xem ghi chú phát hành của SDK Địa điểm cho iOS.
Các phiên bản API Địa điểm cho SDK Địa điểm 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ể có trong ứng dụng, chẳng hạn như 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ả API Địa điểm và API Địa điểm (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 nên bật API Địa điểm (Mới) và sử dụng các 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 các tính năng SDK có trong ứng dụng, hãy làm như sau:
- Trong dự án Google Cloud, hãy bật API Địa điểm, API Địa điểm (Mới) hoặc cả hai. Để biết thêm thông tin, hãy xem phần Bật API
- Trong các quy tắ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 bài viết 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 bài viết Thiết lập dự án trên Google Cloud.
Các tính năng SDK có trong mỗi phiên bản
Bảng sau đây cho biết các phiên bản SDK và API cần thiết cho từng tính năng SDK:
| SDK Địa điểm dành cho iOS (Mới) | Phiên bản SDK tối thiểu | SDK Địa điểm dành cho iOS | Phiên bản SDK tối thiểu |
|---|---|---|---|
| Thông tin chi tiết về địa điểm (Mới) | 9.0.0 | Thông tin chi tiết về địa điểm | 3.0.0 |
| Ảnh địa điểm (Mới) | 9.0.0 | Place Photo | 3.0.0 |
| Tìm kiếm bằng văn bản (Mới) | 8.5.0 | ||
| Tìm kiếm lân cận (Mới) | 9.0.0 | ||
| Tự động hoàn thành (Mới) | 9.0.0 | Tự động hoàn thành | 3.0.0 |
| Địa điểm hiện tại | 3.0.0 |
Những điều cần cân nhắc khi chọn phiên bản để bật
- Nếu bạn là khách hàng mới và mới bắt đầu sử dụng SDK Địa điểm cho iOS, hãy bắt đầu với API Địa điểm (Mới) và SDK mới.
- Nếu là khách hàng hiện tại, bạn có thể tiếp tục sử dụng SDK hiện có. Tuy nhiên, để tận dụng các tính năng cải tiến và cải thiện hiệu suất của SDK Địa điểm dành cho iOS (Mới), bạn nên bật API Địa điểm (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 phần 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.isOpenvàGMSPlace.isOpenAtDate.
Sử dụng SDK Swift của Địa điểm dành cho iOS (Bản dùng thử)
Bạn cần thực hiện các bước sau để sử dụng SDK Swift của Địa điểm dành cho iOS (Bản xem trước):
- Bật API Địa điểm (Mới).
- Thêm SDK Swift của Địa điểm dành cho iOS (Bản xem trước) vào phần phụ thuộc.
- Khởi động ứng dụng Places bằng
PlacesClient.
Để tìm hiểu thêm về SDK Swift của Địa điểm dành cho iOS (Bản xem trước), hãy xem tổng quan hoặc hướng dẫn di chuyển.
Di chuyển sang các API mới
Nếu bạn đang sử dụng một API hiện có và muốn di 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 sang phần Thông tin chi tiết về địa điểm (Mới)
- Di chuyển sang tính năng Đặt ảnh (Mới)
- Di chuyển sang tính năng Tự động hoàn thành (Mới)
Các điểm cải tiến trong SDK Địa điểm dành cho iOS (Mới)
Phần này trình bày 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 chuẩn của 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ế 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, giúp bạn nên thay thế các ứng dụng sử 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 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)
- Hình ảnh về địa điểm (Mới)
- Tìm kiếm bằng văn bản (Mới)
Giá đơn giản
Giá được đơn giản hoá bằng SDK Địa điểm dành cho iOS (Mới) để bạn chỉ phải trả tiền cho dữ liệu mà bạn sử dụng. Tính năng định giá đơn giản được triển khai bằng cách sử dụng danh sách trường, còn gọi là mặt nạ trường.
Với SDK Địa điểm dành cho iOS và tính năng 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 sẽ trả về trong phản hồi. Sau đó, bạn chỉ phải trả phí cho dữ liệu đã yêu cầu. Bạn nên sử dụng danh sách trường để đả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à phí thanh toán không cần thiết.
Để biết thông tin chi tiết về giá của cả hai SDK, hãy xem phần Sử dụng và thanh toán.
Các loại địa điểm mở rộng
SDK mới thêm các loại địa điểm như trong bảng sau. Các loại này được trả về trong phần Thông tin chi tiết về địa điểm và phản hồi Tìm kiếm bằng 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 một lượt tìm kiếm bằng tính năng Tìm kiếm bằng văn bản. Các loại mới được đưa vào 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 | nhà nghỉ dưỡng ở 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 | điều chỉnh |
| 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 |
| chuyên gia 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) đã di chuyển các loại sau đây từ Bảng 2 của Places API sang Bảng A của 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 trong một nội dung tìm kiếm:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality