Die Places API unterstützt das vorhandene Place Photo. Wenn Sie das vorhandene Place Photo bereits kennen, werden in der neuen Version von Place Photo folgende Änderungen vorgenommen:
- Für den neuen „Place Photo“-Dienst müssen Sie den Ressourcennamen des Fotos übergeben, der nicht nur die Fotoreferenz, sondern die Orts-ID in der Anfrage-URL enthält. Weitere Informationen findest du unter Zu Fotoreferenzen wechseln.
- Der neue „Place Photo“-Dienst unterstützt sowohl API-Schlüssel als auch OAuth als Authentifizierungsmechanismus.
In der folgenden Tabelle sind Parameter im vorhandenen Place Photo aufgeführt, die für das neue Place Photo umbenannt oder geändert wurden oder nicht mehr unterstützt werden.
| Aktueller Parameter | Neuer Parameter | Hinweise |
|---|---|---|
maxheight |
maxHeightPx |
Sie müssen entweder maxHeightPx, maxWidthPx oder beide angeben. |
maxwidth |
maxWidthPx |
Sie müssen entweder maxHeightPx, maxWidthPx oder beide angeben. |
Fotos vergrößert
Das vorhandene Ortsfoto unterstützte eine maximale Fotogröße von 1.600 × 1.600 Pixeln. „Place Photo (New)“ unterstützt Größen von bis zu 4.800 × 4.800 Pixeln.
Zu Fotoreferenzen ändern
Für die neue Place Photo API müssen Sie den Ressourcennamen des angeforderten Fotos, das eine Orts-ID und die Fotoreferenz enthält, im folgenden Format übergeben:
https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY
Die neuen Versionen von Nearby Search, Text Search und Place Details geben in der Antwort, die dieses Format unterstützt, ein photos[]-Array zurück. Jedes Element von photos[] in der neuen Antwort enthält die folgenden Felder:
name: Ein String, der den Ressourcennamen des Fotos enthält. Diese Zeichenfolge hat das 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.
Mit der vorhandenen API müssen Sie nur die Fotoreferenz im folgenden Format übergeben:
https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY
Die vorhandenen „Find Place“-, „Nearby Search“-, „Text Search“- und „Place Details“-Details in der Antwort geben ein photos[]-Array zurück, das dieses Format unterstützt. Jedes photo-Element in der vorhandenen Antwort enthält die folgenden Felder:
photo_reference: Ein String, mit dem das Foto bei einer Fotoanfrage identifiziert wird.height: Die maximale Höhe des Bildes.width: Die maximale Breite des Bilds.html_attributions[]: alle erforderlichen Quellenangaben. Dieses Feld ist immer vorhanden, kann aber leer sein.