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.
Detail Tempat (Baru) mendukung
kunci API
dan token OAuth
sebagai mekanisme autentikasi.
Hanya JSON yang didukung sebagai format respons di Place Details (Baru).
Format respons JSON untuk Places API (Baru)
telah berubah dari format API lama. Untuk mengetahui detail selengkapnya, lihat bagian
Memigrasikan respons Places API.
Tabel berikut mencantumkan parameter di Place Details (Lama) yang telah diganti namanya atau diubah untuk Place Details (Baru), atau parameter yang tidak lagi didukung.
Parameter saat ini
Parameter baru
Catatan
place_id
places/PLACE_ID
String places/PLACE_ID juga disebut sebagai
nama resource tempat. Dalam respons dari permintaan Place Details (Baru),
Nearby Search (Baru), dan Text Search (Baru), string ini terdapat di kolom name dalam respons.
ID tempat mandiri terdapat di kolom id respons.
language
languageCode
region
regionCode
Contoh permintaan
Contoh permintaan GET berikut menggunakan Place Details (Legacy). Dalam contoh ini, Anda meminta respons JSON yang berisi informasi tentang ID tempat dan meneruskan semua parameter sebagai parameter URL. Contoh ini juga menggunakan fields sehingga
respons hanya menyertakan nama tampilan dan alamat yang diformat dari tempat tersebut:
curl -L -X GET \
'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJj61dQgK6j4AR4GeTYWZsKWw&fields=name%2Cformatted_address&key=API_KEY'
Dengan Place Details (Baru), Anda membuat permintaan GET dan meneruskan semua parameter
dalam parameter dan header URL sebagai bagian dari permintaan. Contoh ini juga menggunakan
mask kolom sehingga respons hanya menyertakan nama tampilan dan alamat yang diformat
tempat:
String places/PLACE_ID juga disebut sebagai
nama resource tempat. Dalam respons dari permintaan Place Details (Baru),
Nearby Search (Baru), dan Text Search (Baru), string ini
terdapat dalam kolom name respons. ID tempat mandiri terdapat di kolom id respons.
[null,null,["Terakhir diperbarui pada 2025-08-29 UTC."],[],[],null,["# Migrate to Place Details (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[Place Details (Legacy)](/maps/documentation/places/web-service/details).\nIf you are familiar with Places API (Legacy), [Place Details (New)](/maps/documentation/places/web-service/place-details)\nmakes the following changes:\n\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/place-details#fieldmask).\n- Place Details (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 Place Details (New).\n- The JSON response format for Places API (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 Place Details (Legacy) that have been\nrenamed or modified for Place Details (New), or parameters that are no\nlonger supported.\n\n| Current parameter | New parameter | Notes |\n|-------------------|---------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `place_id` | `places/`\u003cvar translate=\"no\"\u003ePLACE_ID\u003c/var\u003e | The string `places/`\u003cvar translate=\"no\"\u003ePLACE_ID\u003c/var\u003e is also called the place *resource name* . In the response from a Place Details (New), Nearby Search (New), and Text Search (New) request, this string is contained in the `name` field of the response. The standalone place ID is contained in the `id` field of the response. |\n| `language` | `languageCode` | |\n| `region` | `regionCode` | |\n\nExample request\n---------------\n\nThe following example GET request uses the Place Details (Legacy). In this\nexample, you request a JSON response containing information about a place ID and\npass all parameters as URL parameters. This example also uses `fields` so the\nresponse only includes the display name and formatted address of the place: \n\n```curl\ncurl -L -X GET \\\n'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJj61dQgK6j4AR4GeTYWZsKWw&fields=name%2Cformatted_address&key=API_KEY'\n```\n\nWith Place Details (New), you make a GET request and pass all parameters\nin URL parameters and headers as part of the request. This example also uses a\nfield mask so the response only includes the display name and formatted address\nof the place: \n\n```\ncurl -X GET -H 'Content-Type: application/json' \\\n-H \"X-Goog-Api-Key: API_KEY\" \\\n-H \"X-Goog-FieldMask: displayName,formattedAddress\" \\\nhttps://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw\n```\n\nThe string `places/`\u003cvar translate=\"no\"\u003ePLACE_ID\u003c/var\u003e is also called the place\n*resource name* . In the response from a Place Details (New),\nNearby Search (New), and Text Search (New) request, this string\nis contained in the `name` field of the response. The standalone place ID is\ncontained in the `id` field of the response.\n| **Note:** In the [Place Details (Legacy)](/maps/documentation/places/web-service/details), the `name` field of the response contained the human-readable name for the place. In the new API, that field is now called `displayName`."]]
