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

SDK Địa điểm dành cho iOS phiên bản 8.5.0 hỗ trợ hai phiên bản SDK: SDK Địa điểm dành cho iOSSDK Địa điểm dành cho iOS (Mới) hiện có là phiên bản thế hệ tiếp theo của SDK.

Với việc phát hành SDK Địa điểm dành cho iOS phiên bản 8.5.0, nhiệm vụ đầu tiên của bạn là quyết định xem nên sử dụng SDK nào. Điều này đúng nếu bạn là khách hàng mới hoặc khách hàng hiện tại đang sử dụng SDK. Hãy sử dụng hướng dẫn này để tìm hiểu những điểm khác biệt chính giữa 2 SDK.

Cách chọn phiên bản SDK

SDK Địa điểm dành cho iOS dựa trên dịch vụ API Địa điểm. Để có thể sử dụng SDK Địa điểm dành cho iOS, bạn phải bật dịch vụ API Địa điểm trong dự án Google Cloud của mình.

Phiên bản dịch vụ Places API mà bạn bật sẽ kiểm soát phiên bản SDK mà ứng dụng của bạn sử dụng:

  • API Địa điểm: Bật SDK Địa điểm dành cho iOS hiện có. Nếu bạn chỉ bật API Địa điểm cho dự án liên kết với khoá API dùng cho ứng dụng, thì ứng dụng sẽ không có quyền truy cập vào các tính năng mới được thêm trong SDK Địa điểm dành cho iOS phiên bản 8.5.0 trở lên.

  • API Địa điểm (Mới): Bật SDK Địa điểm dành cho iOS (Mới), bao gồm tính năng Tìm kiếm văn bản và tất cả các tính năng mới được mô tả trong Các tính năng chính được thêm vào SDK Địa điểm dành cho iOS (Mới). Không bật các tính năng hiện có như Chi tiết về địa điểm, Ảnh về địa điểm, Địa điểm hiện tại và Tự động hoàn thành địa điểm.

  • Cả hai: Bật tất cả các tính năng cho cả SDK Địa điểm dành cho iOS (Mới)SDK Địa điểm dành cho iOS.

Để biết thêm thông tin về cách chọn dịch vụ Places API, hãy xem bài viết Thiết lập dự án Google Cloud.

Bạn chọn SDK nào?

Để giúp quyết định phiên bản sẽ chọn:

  1. Nếu bạn là khách hàng mới vừa mới bắt đầu sử dụng SDK Địa điểm dành cho iOS, hãy bắt đầu bằng cả API Địa điểm (Mới) và API Địa điểm để có quyền truy cập vào tất cả các tính năng.

  2. 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 điểm cải tiến về hiệu suất và các tính năng nâng cao về tính năng của SDK Địa điểm dành cho iOS (Mới), bạn có thể sử dụng SDK mới.

    Bạn không cần phải di chuyển khi chuyển sang SDK mới. Bạn chỉ phải bật SDK Địa điểm dành cho iOS (Mới) trên khoá API dùng trong ứng dụng. Nếu đang dùng cả SDK Địa điểm dành cho iOSSDK Địa điểm dành cho iOS (Mới), hãy bật cả hai phiên bản trên khoá API. Để biết thêm thông tin, hãy xem bài viết Sử dụng khoá API.

Đã thêm các tính năng chính vào SDK Địa điểm 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 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 với 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, vì vậy, bạn nên thay thế các ứng dụng sử dụng SDK hiện có.

Tìm kiếm văn bản trả về thông tin về một tập hợp các địa điểm dựa trên một chuỗi – ví dụ: "pizza ở New York" hoặc "cửa hàng giày gần Ottawa" hoặc "123 Main Street". Dịch vụ phản hồi bằng một danh sách các địa điểm khớp với chuỗi văn bản và mọi độ chệch vị trí đã đặt.

Giá đơn giản

Việc định giá được đơn giản hoá nhờ SDK Địa điểm dành cho iOS (mới) để bạn chỉ phải trả cho dữ liệu mà bạn sử dụng. Quy trình đặt 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 iOSTì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ỉ bị tính 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ế hay để đả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á cho cả hai SDK, hãy xem phần Sử dụng và thanh toán.

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

SDK mới thêm các loại địa điểm hiển thị trong bảng sau. Các loại này được trả về như một phần của phản hồi Thông tin chi tiết về đị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ó khi 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 đư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 nghỉ 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 tuỳ 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
tư vấn viên sân bay trực thăng playground vegetarian_restaurant
convention_center hiking_area mẫu giáo 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 những loại sau từ Bảng B khỏi Bảng A. Điều đó có nghĩa là bạn hiện có thể sử dụng các loại sau đây trong quá trình tìm kiếm:
  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality