Einführung
Die Places API unterstützt „Place Photos (Legacy)“. Wenn Sie mit „Place Photos (Legacy)“ vertraut sind, „Place Photos (New)“ führt die folgenden Änderungen ein:
- Bei „Place Photos (New)“ müssen Sie anstelle der Fotoreferenz den Ressourcennamen des Fotos übergeben, der die Orts-ID in der Anfrage-URL enthält. Weitere Informationen finden Sie unter Änderung an Fotoreferenzen.
- „Place Photos (New)“ unterstützt sowohl API-Schlüssel als auch OAuth Tokens als Authentifizierungsmechanismus.
In der folgenden Tabelle sind die 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. |
Erhöhte Fotogröße
„Place Photos (Legacy)“ unterstützte eine maximale Fotogröße von 1.600 × 1.600 Pixel. „Place Photos (New)“ unterstützt Größen von bis zu 4.800 × 4.800 Pixel.
Änderung an Fotoreferenzen
Für die Place Photos (New) API müssen Sie den Ressourcennamen des angeforderten Fotos übergeben, der eine Orts-ID und die Fotoreferenz enthält. Das Format ist wie folgt:
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 mit dem Ressourcennamen des Fotos. Dieser String hat das folgende Format:places/PLACE_ID/photos/PHOTO_REFERENCE
heightPx: Die maximale Höhe des Bilds in Pixeln.widthPx: Die maximale Breite des Bilds in Pixeln.authorAttributions[]: Alle erforderlichen Quellenangaben. Dieses Feld ist immer vorhanden, kann aber leer sein.
Bei der Legacy API müssen Sie nur die Fotoreferenz übergeben. Das Format ist wie folgt:
https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY
„Find Place (Legacy)“, „Nearby Search (Legacy)“, „Text Search (Legacy)“ und „Place Details (Legacy)“ geben alle ein photos[]-Array in der Antwort zurück, das dieses Format unterstützt. Jedes photo-Element in der Legacy-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 Bilds.width: Die maximale Breite des Bilds.html_attributions[]: Alle erforderlichen Quellenangaben. Dieses Feld ist immer vorhanden, kann aber leer sein.