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 nên 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 các API. Hãy xem hướng dẫn này để hiểu rõ sự khác biệt chính 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 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) | Các tính năng được thêm vào tính năng 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 sẽ 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 được 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): 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 các API mới
Nếu bạn đang sử dụng một API hiện có và muốn di chuyển sang API mới, hãy xem các 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 bằng văn bản (Mới)
- Di chuyển sang phầ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 tiêu 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 trên các API, giúp cải thiện hiệu quả phát triển bằng API Địa điểm (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
Chúng tôi đã đơn giản hoá việc tính phí bằng API Địa điểm (Mới) để bạn chỉ phải trả phí cho dữ liệu mà bạn 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 chỉ phải trả phí cho dữ liệu đã yêu cầu. Việc sử dụng tính năng che trường là một phương pháp thiết kế hay để đả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ó, 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. API Địa điểm (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.
Các loại địa điểm mở rộng
Phản hồi 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 được chỉ định là 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 |
| chuyên viên 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 động
API Địa điểm (Mới) hỗ trợ dữ liệu phản hồi động, chẳng hạn như tình trạng còn chỗ 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.