Foto Tempat (Baru) mengharuskan Anda
meneruskan nama resource foto, yang mencakup ID tempat dalam
URL permintaan, bukan hanya referensi foto. Untuk mengetahui informasi selengkapnya, lihat
Perubahan pada referensi foto.
Place Photos (Baru) mendukung
kunci API
dan token OAuth
sebagai mekanisme autentikasi.
Tabel berikut mencantumkan parameter di Place Photos (Lama) yang telah diganti namanya atau diubah untuk Place Photos (Baru), atau parameter yang tidak lagi didukung.
Parameter saat ini
Parameter baru
Catatan
maxheight
maxHeightPx
Anda harus menentukan salah satu dari maxHeightPx,
maxWidthPx, atau keduanya.
maxwidth
maxWidthPx
Anda harus menentukan salah satu dari maxHeightPx,
maxWidthPx, atau keduanya.
Ukuran foto yang lebih besar
Place Photos (Lama) mendukung ukuran foto maksimum 1600 x 1600 piksel. Foto yang ditempatkan (Baru)
mendukung ukuran hingga 4800 x 4800 piksel.
Beralih ke referensi foto
API Place Photos (Baru)
mengharuskan Anda meneruskan nama resource foto yang diminta, yang
mencakup ID tempat dan referensi foto, dalam bentuk:
Nearby Search (Baru),
Text Search (Baru), dan
Place Details (Baru)
semuanya menampilkan array photos[] dalam respons yang mendukung format ini. Setiap elemen photos[] dalam respons baru berisi kolom berikut:
name — String yang berisi nama resource
foto. String ini dalam bentuk:
places/PLACE_ID/photos/PHOTO_REFERENCE
heightPx — Tinggi maksimum gambar, dalam piksel.
widthPx — Lebar maksimum gambar, dalam piksel.
authorAttributions[] — Atribusi yang diperlukan. Kolom
ini selalu ada, tetapi mungkin kosong.
Dengan API lama, Anda hanya perlu meneruskan referensi foto, dalam
bentuk:
Find Place (Lama),
Nearby Search (Lama),
Text Search (Lama), dan
Place Details (Lama) semuanya menampilkan array photos[] dalam
respons yang mendukung format ini. Setiap elemen photo dalam respons
lama berisi kolom berikut:
photo_reference — String yang digunakan untuk mengidentifikasi foto saat Anda
melakukan permintaan Foto.
height — Tinggi maksimum gambar.
width — Lebar maksimum gambar.
html_attributions[] — Atribusi yang diperlukan. Kolom ini selalu ada, tetapi mungkin kosong.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-09-04 UTC."],[],[],null,["**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\nThe Places API supports\n[Place Photos (Legacy)](/maps/documentation/places/web-service/photos).\nIf you are familiar with Place Photos (Legacy),\n[Place Photos (New)](/maps/documentation/places/web-service/place-photos)\nmakes the following changes:\n\n- Place Photos (New) requires that you pass the resource name of the photo, which includes the place ID in the request URL, instead of just the photo reference. For more information, see [Change to photo references](#photo-ref).\n- Place Photos (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\nThe following table lists parameters in\nPlace Photos (Legacy) that have been renamed or\nmodified for Place Photos (New), or parameters\nthat are no longer supported.\n\n| Current parameter | New parameter | Notes |\n|-------------------|---------------|---------------------------------------------------------------|\n| `maxheight` | `maxHeightPx` | You must specify either `maxHeightPx`, `maxWidthPx`, or both. |\n| `maxwidth` | `maxWidthPx` | You must specify either `maxHeightPx`, `maxWidthPx`, or both. |\n\nIncreased photo size\n\nPlace Photos (Legacy) supported a maximum photo\nsize of 1600 by 1600 pixels. Place Photos (New)\nsupports sizes up to 4800 by 4800 pixels.\n\nChange to photo references\n\n[Place Photos (New)](/maps/documentation/places/web-service/place-photos)\nAPI requires that you pass the *resource name* of the requested photo, which\nincludes a **place ID** and the **photo reference**, in the form: \n\n```json\nhttps://places.googleapis.com/v1/places/\u003cvar translate=\"no\"\u003ePLACE_ID\u003c/var\u003e/photos/\u003cvar translate=\"no\"\u003ePHOTO_REFERENCE\u003c/var\u003e/media?maxWidthPx=400&key=\u003cvar translate=\"no\"\u003eAPI_KEY\u003c/var\u003e\n```\n\nNearby Search (New),\nText Search (New), and\nPlace Details (New)\nall return a `photos[]` array in the response that supports this format. Each\nelement of `photos[]` in the new response contains the following fields:\n\n- `name` --- A string containing the resource name of the\n photo. This string is in the form:\n\n ```\n places/PLACE_ID/photos/PHOTO_REFERENCE\n ```\n- `heightPx` --- The maximum height of the image, in pixels.\n- `widthPx` --- The maximum width of the image, in pixels.\n- `authorAttributions[]` --- Any required attributions. This field is always present, but might be empty.\n\nWith the legacy API, you only have to pass the **photo reference**, in the\nform: \n\n```json\nhttps://maps.googleapis.com/maps/api/place/photo?photo_reference=\u003cvar translate=\"no\"\u003ePHOTO_REFERENCE\u003c/var\u003emaxwidth=400&key=\u003cvar translate=\"no\"\u003eAPI_KEY\u003c/var\u003e\n```\n\nFind Place (Legacy),\nNearby Search (Legacy),\nText Search (Legacy), and\nPlace Details (Legacy) all return a `photos[]` array in\nthe response that supports this format. Each `photo` element in the legacy\nresponse contains the following fields:\n\n- `photo_reference` --- A string used to identify the photo when you perform a Photo request.\n- `height` --- The maximum height of the image.\n- `width` --- The maximum width of the image.\n- `html_attributions[]` --- Any required attributions. This field is always present, but might be empty.\n\n| **Note:** The `photo_reference` field does not include the place ID. If you want to use Place Photos (New) with these legacy APIs, you must add the place ID to construct the full resource name."]]
