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) 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 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:
- Di chuyển sang Tìm kiếm lân cận (Mới)
- Di chuyển sang Tìm kiếm văn bản (Mới)
- 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 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:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality
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:
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.
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ó.
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.