Przenieś do wyszukiwania w pobliżu (nowość)
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)
Wprowadzenie
Interfejs Places API obsługuje wyszukiwanie w pobliżu (starsza wersja).
Jeśli znasz interfejs Nearby Search (starszy),
Nearby Search (nowy) wprowadza te zmiany:
- Wyszukiwanie w pobliżu (nowe) korzysta z żądań HTTP POST.
Przekazywanie parametrów w treści żądania lub w nagłówkach w ramach żądania HTTP POST. W przypadku wyszukiwania w pobliżu (starsza wersja) parametry adresu URL przekazujesz za pomocą żądania HTTP GET.
- Maskowanie pola jest wymagane. Musisz określić, które pola mają być zwracane w odpowiedzi. Nie ma domyślnej listy zwracanych pól. Jeśli pominiesz tę listę, metody zwrócą błąd. Więcej informacji znajdziesz w sekcji FieldMask.
- Interfejs Nearby Search (New) obsługuje zarówno klucze interfejsu API, jak i tokeny OAuth jako mechanizm uwierzytelniania.
- W przypadku wyszukiwania w pobliżu (nowego) jako format odpowiedzi obsługiwany jest tylko JSON.
- Wszystkie żądania zawierające zapytanie tekstowe powinny teraz korzystać z wyszukiwania tekstowego (nowego), ponieważ wyszukiwanie w pobliżu (nowe) nie obsługuje wprowadzania tekstu.
- Format odpowiedzi JSON w przypadku wyszukiwania w pobliżu (nowego) zmienił się w porównaniu z formatem starszych interfejsów API. Więcej informacji znajdziesz w artykule Migracja odpowiedzi interfejsu Places API.
W tabeli poniżej znajdziesz parametry wyszukiwania w pobliżu (starsza wersja), które zostały zmienione lub zmodyfikowane w wyszukiwaniu w pobliżu (nowa wersja), oraz parametry, które nie są już obsługiwane.
| Bieżący parametr |
Nowy parametr |
Uwagi |
keyword |
|
Nieobsługiwane. Zamiast niej używaj funkcji Wyszukiwanie tekstowe (nowa). |
language |
languageCode |
|
location |
locationRestriction |
Wymagany. |
maxprice/minprice |
|
Nieobsługiwane. |
|
maxResultCount |
Nowy parametr. |
opennow |
|
Nieobsługiwane. |
pagetoken |
|
Nieobsługiwane. |
radius |
|
Skorzystaj z locationRestriction już teraz |
rankby |
rankPreference |
|
|
regionCode |
Nowy parametr. |
type |
includedTypes
excludedTypes
includedPrimaryTypes
excludedPrimaryTypes
|
Nowe parametry akceptują też wiele wartości typu. Starszy interfejs API
akceptuje tylko jedną wartość. |
Przykładowe żądanie
Ten przykładowy kod wysyła żądanie GET do wyszukiwania w pobliżu (starsza wersja). W tym przykładzie wysyłasz żądanie odpowiedzi w formacie JSON zawierającej informacje o miejscach typu restaurant i przekazujesz wszystkie parametry jako parametry adresu 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'
W przypadku wyszukiwania w pobliżu (nowego) wysyłasz żądanie POST i przekazujesz wszystkie parametry w treści żądania JSON lub w nagłówkach w ramach żądania POST.
W tym przykładzie używamy też maski pola, aby odpowiedź zawierała tylko nazwę wyświetlaną i sformatowany adres miejsca:
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
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-29 UTC.
[null,null,["Ostatnia aktualizacja: 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```"]]
