Di chuyển sang Tìm kiếm lân cận (Mới)
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Nhà phát triển ở Khu vực kinh tế Châu Âu (EEA)
Giới thiệu
Places API hỗ trợ Tìm kiếm lân cận (Cũ).
Nếu bạn đã quen với tính năng Tìm kiếm lân cận (Cũ), thì tính năng
Tìm kiếm lân cận (Mới) sẽ có những thay đổi sau:
- Tính năng Tìm kiếm lân cận (Mới) sử dụng các yêu cầu HTTP POST.
Truyền các tham số trong nội dung yêu cầu hoặc trong tiêu đề dưới dạng một phần của yêu cầu HTTP POST. Ngược lại, với Nearby Search (Legacy), bạn sẽ truyền các tham số URL bằng yêu cầu HTTP GET.
- Bạn phải che trường. Bạn phải chỉ định những trường mà bạn muốn trả về trong phản hồi. Không có danh sách mặc định về các trường được trả về. Nếu bạn bỏ qua danh sách này, các phương thức sẽ trả về lỗi. Để biết thêm thông tin, hãy xem FieldMask.
- Nearby Search (Mới) hỗ trợ cả khoá API và mã thông báo OAuth làm cơ chế xác thực.
- Chỉ JSON được hỗ trợ làm định dạng phản hồi trong tính năng Tìm kiếm lân cận (Mới).
- Tất cả các yêu cầu có chứa cụm từ tìm kiếm dạng văn bản hiện phải sử dụng Tìm kiếm bằng văn bản (Mới) vì Tìm kiếm lân cận (Mới) không hỗ trợ dữ liệu đầu vào dạng văn bản.
- Định dạng phản hồi JSON cho Nearby Search (Mới) đã thay đổi so với định dạng của các API cũ. Để biết thêm thông tin, hãy xem bài viết Di chuyển phản hồi Places API.
Bảng sau đây liệt kê các tham số trong tính năng Tìm kiếm lân cận (Phiên bản cũ) đã được đổi tên hoặc sửa đổi cho tính năng Tìm kiếm lân cận (Phiên bản mới), hoặc các tham số không còn được hỗ trợ.
| Tham số hiện tại |
Thông số mới |
Ghi chú |
keyword |
|
Không được hỗ trợ. Thay vào đó, hãy sử dụng Tìm kiếm bằng văn bản (Mới). |
language |
languageCode |
|
location |
locationRestriction |
Bắt buộc. |
maxprice/minprice |
|
Không được hỗ trợ. |
|
maxResultCount |
Thông số mới. |
opennow |
|
Không được hỗ trợ. |
pagetoken |
|
Không được hỗ trợ. |
radius |
|
Hãy sử dụng locationRestriction ngay. |
rankby |
rankPreference |
|
|
regionCode |
Thông số mới. |
type |
includedTypes
excludedTypes
includedPrimaryTypes
excludedPrimaryTypes
|
Các tham số mới cũng chấp nhận nhiều giá trị loại. API cũ chỉ chấp nhận một giá trị duy nhất. |
Ví dụ về yêu cầu
Yêu cầu GET mẫu sau đây sử dụng tính năng Tìm kiếm lân cận (Phiên bản cũ). Trong ví dụ này, bạn yêu cầu một phản hồi JSON chứa thông tin về những địa điểm thuộc loại restaurant và truyền tất cả các tham số dưới dạng tham số URL:
curl -L -X GET \
'https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=37.7937%2C-122.3965&radius=500&type=restaurant&key=API_KEY'
Với tính năng Tìm kiếm lân cận (Mới), bạn sẽ thực hiện một yêu cầu POST và truyền tất cả các tham số trong nội dung yêu cầu JSON hoặc trong tiêu đề như một phần của yêu cầu POST.
Ví dụ này cũng sử dụng một mặt nạ trường để phản hồi chỉ bao gồm tên hiển thị và địa chỉ được định dạng của địa điểm:
curl -X POST -d '{
"includedTypes": ["restaurant"],
"locationRestriction": {
"circle": {
"center": {
"latitude": 37.7937,
"longitude": -122.3965},
"radius": 500.0
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName,places.formattedAddress" \
https://places.googleapis.com/v1/places:searchNearby
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-29 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-29 UTC."],[],[],null,["# Migrate to Nearby Search (New)\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n\nIntroduction\n------------\n\nPlaces API supports\n[Nearby Search (Legacy)](/maps/documentation/places/web-service/search-nearby).\nIf you are familiar with Nearby Search (Legacy), the [Nearby Search (New)](/maps/documentation/places/web-service/nearby-search) makes the following\nchanges:\n\n- Nearby Search (New) uses HTTP POST requests. Pass parameters in the request body or in headers as part of an HTTP POST request. In contrast, with Nearby Search (Legacy), you pass URL parameters using an HTTP GET request.\n- Field masking is required. You must specify which fields you want returned in the response. There is no default list of returned fields. If you omit this list, the methods return an error. For more information, see [FieldMask](/maps/documentation/places/web-service/nearby-search#fieldmask).\n- Nearby Search (New) supports both [API keys](/maps/documentation/places/web-service/get-api-key) and [OAuth](/maps/documentation/places/web-service/oauth-token) tokens as the authentication mechanism.\n- Only JSON is supported as a response format in Nearby Search (New).\n- All requests that include a text query should now use [Text Search (New)](/maps/documentation/places/web-service/text-search) because Nearby Search (New) does not support text input.\n- The JSON response format for Nearby Search (New) has changed from the format of the legacy APIs. For more details, see [Migrate the Places API response](/maps/documentation/places/web-service/migrate-response).\n\nThe following table lists parameters in Nearby Search (Legacy) that have been\nrenamed or modified for Nearby Search (New), or parameters that are no\nlonger supported.\n\n| Current parameter | New parameter | Notes |\n|---------------------|-------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------|\n| `keyword` | | Not supported. Use [Text Search (New)](/maps/documentation/places/web-service/text-search) instead. |\n| `language` | `languageCode` | |\n| `location` | `locationRestriction` | Required. |\n| `maxprice/minprice` | | Not supported. |\n| | `maxResultCount` | New parameter. |\n| `opennow` | | Not supported. |\n| `pagetoken` | | Not supported. |\n| `radius` | | Use `locationRestriction` now. |\n| `rankby` | `rankPreference` | |\n| | `regionCode` | New parameter. |\n| `type` | `includedTypes` `excludedTypes` `includedPrimaryTypes` `excludedPrimaryTypes` | The new parameters also accept multiple type values. The legacy API only accepts a single value. |\n\nExample request\n---------------\n\nThe following example GET request uses the Nearby Search (Legacy). In this\nexample, you request a JSON response containing information about places of type\n`restaurant` and pass all parameters as URL parameters: \n\n```curl\ncurl -L -X GET \\\n'https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=37.7937%2C-122.3965&radius=500&type=restaurant&key=API_KEY'\n```\n\nWith Nearby Search (New), you make a POST request and pass all\nparameters in the JSON request body or in headers as part of the POST request.\nThis example also uses a field mask so the response only includes the display\nname and formatted address of the place: \n\n```curl\ncurl -X POST -d '{\n \"includedTypes\": [\"restaurant\"],\n \"locationRestriction\": {\n \"circle\": {\n \"center\": {\n \"latitude\": 37.7937,\n \"longitude\": -122.3965},\n \"radius\": 500.0\n }\n }\n}' \\\n-H 'Content-Type: application/json' -H \"X-Goog-Api-Key: API_KEY\" \\\n-H \"X-Goog-FieldMask: places.displayName,places.formattedAddress\" \\\nhttps://places.googleapis.com/v1/places:searchNearby\n```"]]
