API Địa điểm 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 API Địa điểm (Mới), nhiệm vụ đầu tiên của bạn là quyết định sử dụng tập hợp API 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 đã 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 bằng văn bản (Mới) | Không có phiên bản mới của tính năng 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ó có chứa cụm từ tìm kiếm dạng văn bản đều phải sử dụng Tìm kiếm bằng 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 bằng 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) | |
| Place Photo | Ả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 truy vấn | 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:
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 của mình, thì ứng dụng sẽ không có quyền truy cập vào các API mới.
API Địa điểm (Mới): Cho phép tất 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 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 phần 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 Nearby Search (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 sang tính năng Đặt ả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 trình bày các tính năng chính được thêm vào API Địa điểm (Mới).
Được triển khai trên nền tảng chuẩn của Google Cloud
API Địa điểm (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 một nền tảng đáng tin cậy và an toàn 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
API Địa điểm (Mới) cải thiện hiệu suất, giúp bạn thay thế các ứng dụng sử dụng API Địa điểm hiện có một cách hiệu quả.
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ả tiền cho dữ liệu mà mình sử dụng. Tính năng đặt giá đơn giản được triển khai bằng cách sử dụng mặt nạ trường.
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 bằng văn bản (Mới), bạn 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 phản hồi nhất quán cho một địa điểm
Với các API hiện có, API Thông tin chi tiết về địa điểm, API Tìm kiếm lân cận và API Tìm kiếm bằng văn bản trả về nhiều loại 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.
Các 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 còn thêm các loại địa điểm được nêu 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 một lượt 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 bằng văn bản (Mới). Tất cả 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 | nhà nghỉ dưỡng ở 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 | điều 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 |
| 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) đã di chuyển các loại sau đây từ Bảng 2 của Places API sang Bảng A của 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 trong một nội dung 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 độ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:
Nếu bạn là một khách hàng mới mới bắt đầu sử dụng API Địa điểm, hãy bắt đầu với các API mới.
Nếu 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à hiện có.
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à tính năng của API Địa điểm (Mới), bạn có thể di chuyển sang các API mới.
Để biết thêm thông tin về việc di chuyển, hãy xem phần Tổng quan về việc di chuyển.