Usługa Zdjęcia miejsc (nowa) wymaga przekazania nazwy zasobu zdjęcia, która zawiera identyfikator miejsca w adresie URL żądania, zamiast tylko odwołania do zdjęcia. Więcej informacji znajdziesz w artykule Przejście na odwołania do zdjęć.
Interfejs Place Photos (New) obsługuje zarówno klucze API, jak i tokeny OAuth jako mechanizm uwierzytelniania.
W tabeli poniżej znajdziesz parametry z interfejsu Place Photos (starsza wersja), które zostały zmienione lub zmodyfikowane w interfejsie Place Photos (nowa wersja), oraz parametry, które nie są już obsługiwane.
Bieżący parametr
Nowy parametr
Uwagi
maxheight
maxHeightPx
Musisz podać wartość maxHeightPx, maxWidthPx lub obie te wartości.
maxwidth
maxWidthPx
Musisz podać wartość maxHeightPx, maxWidthPx lub obie te wartości.
Zwiększony rozmiar zdjęcia
Zdjęcia w Miejscach (starsza wersja) mogły mieć maksymalny rozmiar 1600 x 1600 pikseli. Zdjęcia miejsc (nowe) obsługują rozmiary do 4800 x 4800 pikseli.
Przejście na odniesienia do zdjęć
Interfejs Place Photos (New) API wymaga przekazania nazwy zasobu żądanego zdjęcia, która zawiera identyfikator miejsca i odwołanie do zdjęcia w formacie:
Wyszukiwanie w pobliżu (nowe), wyszukiwanie tekstowe (nowe) i szczegóły miejsca (nowe) zwracają w odpowiedzi tablicę photos[], która obsługuje ten format. Każdy element photos[] w nowej odpowiedzi zawiera te pola:
name – ciąg tekstowy zawierający nazwę zasobu zdjęcia. Ciąg znaków ma postać:
places/PLACE_ID/photos/PHOTO_REFERENCE
heightPx – maksymalna wysokość obrazu w pikselach.
widthPx – maksymalna szerokość obrazu w pikselach.
authorAttributions[] – wszelkie wymagane informacje o autorze. To pole jest zawsze obecne, ale może być puste.
W przypadku starszej wersji interfejsu API wystarczy przekazać odwołanie do zdjęcia w formacie:
Usługi Znajdź miejsce (starsza wersja), Wyszukiwanie w pobliżu (starsza wersja), Wyszukiwanie tekstowe (starsza wersja) i Szczegóły miejsca (starsza wersja) zwracają w odpowiedzi tablicę photos[], która obsługuje ten format. Każdy element photo w odpowiedzi starszego typu zawiera te pola:
photo_reference – ciąg znaków używany do identyfikowania zdjęcia podczas wysyłania żądania dotyczącego zdjęcia.
height – maksymalna wysokość obrazu.
width – maksymalna szerokość obrazu.
html_attributions[] – wszelkie wymagane informacje o autorze. To pole jest zawsze obecne, ale może być puste.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 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."]]
