Die Places API unterstützt das vorhandene Ortsfoto. Wenn Sie das vorhandene Ortsfoto bereits kennen, sind die folgenden Änderungen bei der neuen Version des Ortsfotos zu beachten:
- Für den neuen Dienst „Ortsfotos“ müssen Sie den Ressourcennamen des Fotos mit der Orts-ID in der Anfrage-URL angeben, anstatt nur die Fotoreferenz. Weitere Informationen finden Sie unter Zu Fotoreferenzen wechseln.
- Der neue Dienst für Fotos von Orten unterstützt sowohl API-Schlüssel als auch OAuth als Authentifizierungsmechanismus.
In der folgenden Tabelle sind Parameter im vorhandenen Ortsfoto aufgeführt, die für das neue Ortsfoto 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. |
Größere Fotos
Das bisherige Fotostandort-Tool unterstützte eine maximale Fotogröße von 1.600 × 1.600 Pixeln. „Ortsfoto (neu)“ unterstützt Größen von bis zu 4.800 × 4.800 Pixeln.
Zu Bildreferenzen wechseln
Für die neue Place Photo API müssen Sie den Ressourcennamen des angeforderten Fotos übergeben. Dieser enthält eine Orts-ID und die Fotoreferenz im folgenden Format:
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 ein photos[]-Array 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 folgende Form: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 in der folgenden Form übergeben:
https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY
Die vorhandenen Funktionen „Ort finden“, „Nearby Search“, „Text Search“ und „Ortsdetails“ geben in der Antwort 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, der zum Identifizieren des Fotos verwendet wird, wenn Sie eine Fotoanfrage stellen.height– die maximale Höhe des Bilds.width– die maximale Breite des Bildes.html_attributions[]: Alle erforderlichen Quellenangaben. Dieses Feld ist immer vorhanden, kann aber leer sein.