Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Entwickler im Europäischen Wirtschaftsraum (EWR)
Einführung
Die Places API unterstützt Place Photos (Legacy).
Wenn Sie mit Place Photos (Legacy) vertraut sind, werden mit Place Photos (New) folgende Änderungen eingeführt:
Für Place Photos (New) müssen Sie den Ressourcennamen des Fotos, der die Orts-ID in der Anfrage-URL enthält, anstelle des Fotoverweises übergeben. Weitere Informationen finden Sie unter Änderung bei Fotoreferenzen.
Die Place Photos API (New) unterstützt sowohl API-Schlüssel als auch OAuth-Tokens als Authentifizierungsmechanismus.
In der folgenden Tabelle sind Parameter in Place Photos (Legacy) aufgeführt, die für Place Photos (New) umbenannt oder geändert wurden, sowie Parameter, die nicht mehr unterstützt werden.
Aktueller Parameter
Neuer Parameter
Hinweise
maxheight
maxHeightPx
Sie müssen entweder maxHeightPx, maxWidthPx oder beides angeben.
maxwidth
maxWidthPx
Sie müssen entweder maxHeightPx, maxWidthPx oder beides angeben.
Größere Fotos
In Place Photos (Legacy) wurde eine maximale Fotogröße von 1.600 × 1.600 Pixel unterstützt. Bei „Fotos einfügen (neu)“ werden Größen bis zu 4.800 × 4.800 Pixel unterstützt.
Zu Fotoreferenzen wechseln
Für die Place Photos API (New) müssen Sie den Ressourcennamen des angeforderten Fotos übergeben, der eine Orts-ID und die Fotoreferenz enthält. Das Format ist:
„Nearby Search (New)“, „Text Search (New)“ und „Place Details (New)“ geben alle ein photos[]-Array in der Antwort zurück, das dieses Format unterstützt. Jedes Element von photos[] in der neuen Antwort enthält die folgenden Felder:
name: Ein String, der den Ressourcennamen des Fotos enthält. Dieser String hat das folgende Format:
places/PLACE_ID/photos/PHOTO_REFERENCE
heightPx: Die maximale Höhe des Bildes in Pixeln.
widthPx: Die maximale Breite des Bildes in Pixeln.
authorAttributions[] – Alle erforderlichen Quellenangaben. Dieses Feld ist immer vorhanden, kann aber leer sein.
Bei der alten API müssen Sie nur die Fotorreferenz in folgendem Format übergeben:
Bei „Find Place“ (Legacy), „Nearby Search“ (Legacy), „Text Search“ (Legacy) und „Place Details“ (Legacy) wird in der Antwort, die dieses Format unterstützt, ein photos[]-Array zurückgegeben. Jedes photo-Element in der alten Antwort enthält die folgenden Felder:
photo_reference: Ein String, mit dem das Foto identifiziert wird, wenn Sie eine Fotoanfrage stellen.
height – Die maximale Höhe des Bildes.
width – Die maximale Breite des Bildes.
html_attributions[] – Alle erforderlichen Quellenangaben. Dieses Feld ist immer vorhanden, kann aber leer sein.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 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."]]
