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à phiên bản thế hệ tiếp theo 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 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 đã sử dụng API. Hãy sử dụng hướng dẫn này để tìm hiểu các đ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 đang là khách hàng, hãy sử dụng bảng này để xác định API mới sẽ 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) | 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ả các yêu cầu sử dụng API hiện có chứa truy vấn văn bản đều phải sử dụng tính nă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 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 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 của mình, thì ứng dụng sẽ không có quyền 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 mới được mô tả trong Các tính năng chính được thêm vào Places SDK 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ụ API Địa điểm, hãy xem nội dung Thiết lập dự á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 hướng dẫn di chuyển sau đây 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. Phương thức 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 tiêu chuẩn này 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, giúp bạn thay thế các ứng dụng dùng Places API hiện có.
Định giá đơn giản
Việc định giá được đơn giản hoá bằng Places API (Mới) để bạn chỉ phải trả phí cho dữ liệu mà mình sử dụng. Phương thức đặt giá đơn giản được triển khai bằng mặt nạ trường.
Với Chi tiết đị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ẽ sử dụng mặt nạ trường để 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ỉ phải trả 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 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à các khoản phí thanh toán không cần thiết.
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ó, API Chi tiết địa điểm, Tìm kiếm lân cận và Tìm kiếm văn bản trả về nhiều dữ liệu phản hồi cho một địa điểm. Places API (Mới) chuẩn hoá phản hồi để 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 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 kiểu mới này và các kiểu hiện có trong kết quả tìm kiếm bằng 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 | lưu trú ở 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 | 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 | playground | 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 sang Bảng A cho Places API (Mới). Điều đó có nghĩa là bạn hiện có thể sử dụng các kiểu này khi 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 hoạt động của trạm sạc xe điện hoặc giá nhiên liệu mới nhất của 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 hoạt.
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 bằng API mới.
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ính năng Tự động hoàn thành theo đị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ó.
Nếu đang 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 thiệ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 Tổng quan về quá trình di chuyển.