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à API hiện có và API Địa điểm (Mới) là các sản phẩm tiếp theo phiên bản tạo của API.

Với việc phát hành Places API (Mới), nhiệm vụ đầu tiên của bạn là quyết định để sử dụng. Điều này đúng nếu bạn là khách hàng mới hoặc hiện tại đã sử dụng API. Hãy xem hướng dẫn này để nắm được sự khác biệt giữa hai 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 sẽ thay thế API bạn đang dùng hiệ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) Chưa có phiên bản mới của Tìm địa điểm. 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ả yêu cầu sử dụng API hiện có mà bao gồm cả truy vấn văn bản đều nên sử dụng Tìm kiếm văn bản (Mới) vì tính năng 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 chi tiết về địa điểm Thông tin chi tiết 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)
Tự động hoàn thành cụm từ tìm kiếm Tự động hoàn thành (Mới) Đã thêm các tính năng vào Tự động hoàn thành (Mới)

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

  • Places API: Bật các API hiện có. Nếu chỉ Địa điểm API được bật cho dự án được liên kết với khoá API dùng cho ứng dụng của bạn, thì ứng dụng đó sẽ không thể truy cập vào các API mới.

  • Places API (Mới): Bật tất cả API và tính năng đượ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). Ứ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ả hai 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 trên Google Cloud.

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 chính được thêm 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 Google Cloud

Places API (Mới) được triển khai trên cơ sở hạ tầng dịch vụ trên Google Cloud. Việc triển khai này mang đến cho nó tính bảo mật và đáng tin cậy hơn nền tảng với các lựa chọn bảo mật nâng cao như OAuth. API chuẩn này thiết kế mang lại mức độ nhất quán giữa 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, việc thay thế các ứng dụng dùng API Địa điểm hiện có là việc đáng để thay thế.

Định giá đơn giản

Việc đặt giá được đơn giản hoá với Places API (Mới) để bạn chỉ trả tiền cho dữ liệu bạn sử dụng. Phương thức định giá đơn giản được triển khai bằng cách sử dụng fieldMask (mặt nạ trường).

Có 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 để 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 thanh toán cho dữ liệu đã yêu cầu. Sử dụng tính năng che giấu trường là một phương pháp thiết kế hay để đảm bảo rằng bạn đừng yêu cầu dữ liệu không cần thiết, để tránh thời gian xử lý không cần thiết và các khoản phí thanh toán.

Dữ liệu câu trả lời nhất quán cho một địa điểm

Với các API hiện có, 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 API trả về 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 để tất cả các API này đều trả về cùng một dữ liệu cho một địa điểm.

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

Giờ đây, phản hồi của API có thể chứa loại chính của một địa điểm. Mọi địa điểm đều 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ư được 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 xuất hiện trong bảng bên dưới. Bạn 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 với Tìm kiếm lân cận (Mới) và Tìm kiếm văn bản (Mới). Tất cả các loại mới đều đượ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 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

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òn hàng của 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. Sử dụng các trường phản hồi này để tạo trải nghiệm người dùng linh độ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 với các API mới.

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

  3. Nếu đang là khách hàng hiện tại, bạn có thể tiếp tục sử dụng gói thuê bao API. Tuy nhiên, để tận dụng những đ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ề quá trình di chuyển, hãy xem phần Di chuyển tổng quan.