Die Places API unterstützt das vorhandene Place Photo-Objekt. Wenn Sie mit dem vorhandenen Place Photo-Format vertraut sind, werden in der neuen Version von Place Photo die folgenden Änderungen vorgenommen:
- Für den neuen „Place Photo“-Dienst muss der Ressourcenname des Fotos übergeben werden. Dieser enthält die Orts-ID in der Anfrage-URL und nicht nur die Fotoreferenz. Weitere Informationen findest du unter Zu Fotoreferenzen ändern.
- Der neue „Place Photo“-Dienst unterstützt sowohl API-Schlüssel als auch OAuth als Authentifizierungsmechanismus.
In der folgenden Tabelle sind Parameter des vorhandenen „Place Photo“-Objekts aufgeführt, die für das neue Place Photo umbenannt oder geändert wurden, oder 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. |
Fotogröße erhöht
Das vorhandene „Place Photo“-Objekt unterstützte eine maximale Fotogröße von 1.600 × 1.600 Pixeln. „Place Photo (New)“ unterstützt Größen bis zu 4.800 × 4.800 Pixel.
An Fotoreferenzen ändern
Für die neue Place Photo API muss der Ressourcenname des angeforderten Fotos übergeben werden. Er muss eine Orts-ID und die Fotoreferenz im folgenden Format enthalten:
https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY
Bei den neuen Versionen von „Nearby Search“, „Text Search“ und „Place Details“ wird in der Antwort alle ein photos[]-Array zurückgegeben, 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 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 vorhandenen API müssen Sie nur die Fotoreferenz in folgendem 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“-Anfragen geben alle ein photos[]-Array in der Antwort zurück, das dieses Format unterstützt. Jedes photo-Element in der vorhandenen Antwort enthält die folgenden Felder:
photo_reference: Ein String zur Identifizierung des Fotos, 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.