Bermigrasi ke Nearby Search (Baru)
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Developer Wilayah Ekonomi Eropa (EEA)
Pengantar
Places API mendukung
Nearby Search (Lama).
Jika Anda sudah familiar dengan Nearby Search (Legacy),
Nearby Search (Baru) melakukan perubahan berikut:
- Nearby Search (Baru) menggunakan permintaan HTTP POST.
Teruskan parameter dalam isi permintaan atau di header sebagai bagian dari permintaan
HTTP POST. Sebaliknya, dengan Nearby Search (Legacy),
Anda meneruskan parameter URL menggunakan permintaan HTTP GET.
- Penyamaran kolom wajib diisi. Anda harus menentukan kolom mana yang ingin ditampilkan dalam respons. Tidak ada daftar default kolom yang ditampilkan. Jika Anda tidak menyertakan
daftar ini, metode akan menampilkan error. Untuk mengetahui informasi selengkapnya, lihat
FieldMask.
- Nearby Search (Baru) mendukung
kunci API
dan token OAuth
sebagai mekanisme autentikasi.
- Hanya JSON yang didukung sebagai format respons di
Nearby Search (Baru).
- Semua permintaan yang menyertakan kueri teks kini harus menggunakan
Text Search (Baru)
karena Nearby Search (Baru) tidak mendukung input teks.
- Format respons JSON untuk Nearby Search (Baru)
telah berubah dari format API lama. Untuk mengetahui detail selengkapnya, lihat bagian
Memigrasikan respons Places API.
Tabel berikut mencantumkan parameter di Nearby Search (Lama) yang telah diganti namanya atau diubah untuk Nearby Search (Baru), atau parameter yang tidak lagi didukung.
| Parameter saat ini |
Parameter baru |
Catatan |
keyword |
|
Tidak didukung. Sebagai gantinya, gunakan
Text Search (Baru). |
language |
languageCode |
|
location |
locationRestriction |
Wajib. |
maxprice/minprice |
|
Tidak didukung. |
|
maxResultCount |
Parameter baru. |
opennow |
|
Tidak didukung. |
pagetoken |
|
Tidak didukung. |
radius |
|
Gunakan locationRestriction sekarang. |
rankby |
rankPreference |
|
|
regionCode |
Parameter baru. |
type |
includedTypes
excludedTypes
includedPrimaryTypes
excludedPrimaryTypes
|
Parameter baru juga menerima beberapa nilai jenis. API lama
hanya menerima satu nilai. |
Contoh permintaan
Contoh permintaan GET berikut menggunakan Nearby Search (Legacy). Dalam
contoh ini, Anda meminta respons JSON yang berisi informasi tentang tempat dengan jenis
restaurant dan meneruskan semua parameter sebagai parameter 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'
Dengan Nearby Search (Baru), Anda membuat permintaan POST dan meneruskan semua parameter di isi permintaan JSON atau di header sebagai bagian dari permintaan POST.
Contoh ini juga menggunakan mask kolom sehingga respons hanya menyertakan nama tampilan dan alamat yang diformat dari tempat:
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
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-29 UTC.
[null,null,["Terakhir diperbarui pada 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```"]]
