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

Places API hỗ trợ hai phiên bản API: API Địa điểm là các API hiện có và API Địa điểm (Mới) là phiên bản API thế hệ tiếp theo.

Với bản phát hành Places API (Mới), nhiệm vụ đầu tiên của bạn là quyết định tập hợp API nào sẽ sử dụng. Đ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 các API. Hãy sử dụng hướng dẫn này để hiểu rõ những điểm khác biệt chính giữa 2 API.

Danh sách API

Bảng sau đây liệt kê cả hai bộ API. Nếu bạn là khách hàng hiện tại, hãy sử dụng bảng này để xác định API mới thay thế API mà bạn đang sử dụng.

Places API Places API (Mới) Lưu ý:
Tìm địa điểm Tìm kiếm văn bản (Mới) Không có phiên bản Tìm địa điểm mới. Tính năng Tìm kiếm văn bản (Mới) đã thay thế tính năng này.
Tìm kiếm lân cận Tìm kiếm lân cận (Mới) Tất cả các yêu cầu sử dụng API hiện có bao gồm truy vấn văn bản nên sử dụng Tìm kiếm văn bản (Mới) vì Tìm kiếm lân cận (Mới) không hỗ trợ nhập văn bản.
Tìm kiếm văn bản Tìm kiếm văn bản (Mới)
Thông tin về địa điểm Thông tin về địa điểm (Mới)
Ảnh địa điểm Ảnh địa điểm (Mới)
Tự động hoàn thành địa điểm Tự động hoàn thành (Mới) Ở chế độ xem trước
Tự động hoàn thành truy vấn Tự động hoàn thành (Mới) Các chức năng được thêm vào phiên bản Xem trước của tính năng Tự động hoàn thành (Mới)

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

  • API Địa điểm: Bật các API 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 của bạn sẽ không có quyền truy cập vào các API mới đó.

  • API Địa điểm (Mới): Bật tất cả các API và tính năng mới được mô tả trong phần Các tính năng chính được thêm vào SDK Địa điểm dành cho iOS (Mới). Ứng dụng của bạn sẽ không có quyền truy cập vào các API hiện có.

  • Cả hai: Bật tất cả các tính năng và API cho cả SDK Địa điểm dành cho iOS (Mới) và 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.

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 các hướng dẫn di chuyển sau đây cho từng API:

Thêm tính năng chính vào Places API (Mới)

Phần này đề cập đến các tính năng chính được thêm vào Places API (Mới).

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

Places API (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 với các tuỳ chọn bảo mật nâng cao như OAuth. Thiết kế API chuẩn này mang lại mức độ nhất quán trên các API, giúp cải thiện hiệu quả phát triển bằng Places API (Mới).

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

Places API (Mới) cải thiện hiệu suất, rất đáng để thay thế các ứng dụng sử dụng Places API hiện có.

Giá đơn giản

Việc định giá được đơn giản hoá với Places API (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 mặt nạ cho trường (field mask).

Với Thông tin chi tiết về địa điểm (Mới), Tìm kiếm lân cận (Mới) và Tìm kiếm văn bản (Mới), bạn sử dụng mặt nạ trường (field mask) để kiểm soát danh sách các 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 tính năng che giấu 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à phí thanh toán không cần thiết.

Dữ liệu phản hồi nhất quán cho một địa điểm

Với các API hiện có, các API Thông tin chi tiết về địa điểm, Tìm kiếm lân cận và Tìm kiếm văn bản đã trả về những dữ liệu phản hồi khác nhau cho một địa điểm. Places API (Mới) chuẩn hoá phản hồi để các API này trả về cùng một dữ liệu cho một địa điểm.

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

Phản hồi của API hiện có thể chứa loại chính của một địa điểm. Mỗi địa điểm có thể có một giá trị loại duy nhất được chỉ định làm loại chính của địa điểm, như liệt kê trong Bảng A.

Ngoài ra, API mới này còn thêm các loại địa điểm như trong bảng dưới đây. Bạn 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 với tính năng Tìm kiếm lân cận (Mới) và Tìm kiếm văn bản (Mới). Các loại mới đều có 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 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

Dữ liệu địa điểm linh động

Places API (Mới) hỗ trợ dữ liệu phản hồi động, chẳng hạn như tình trạng có sẵn của một trạm sạc xe điện hoặc giá nhiên liệu mới nhất của một trạm xăng. Hãy sử dụng các trường phản hồi này để tạo trải nghiệm người dùng động.

Bạn chọn API nào?

Trước khi có thể bắt đầu phát triển ứng dụng, bạn phải chọn API của mình:

  1. Nếu bạn là khách hàng mới chỉ mới bắt đầu sử dụng Places API thì hãy bắt đầu bằng các API mới này.

  2. Nếu bạn là khách hàng mới và chưa có API thay thế cho một API hiện có, chẳng hạn như Tự động hoàn thành địa điểm hoặc Tự động hoàn thành truy vấn, thì bạn có thể sử dụng kết hợp các API mới và API hiện có.

  3. Nếu là khách hàng hiện tại, bạn có thể tiếp tục sử dụng các API 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 API (Mới), bạn có thể chuyển sang các API mới.

    Để biết thêm thông tin về việc di chuyển, hãy xem bài viết Tổng quan về quá trình di chuyển.