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.
- Place Photos (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 Bildgröße von 1.600 × 1.600 Pixel unterstützt. Bei „Fotos für Orte“ (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, und zwar in folgendem Format:
https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY
„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:
https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY
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.