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 zu Fotoreferenzen.
- Die Place Photos API (New) unterstützt sowohl API-Schlüssel als auch OAuth-Tokens als Authentifizierungsmechanismus.
Die folgende Tabelle listet Parameter in Place Photos (Legacy) auf, die für Place Photos (New) 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. |
Vergrößerte Fotogröße
Place Photos (Legacy) unterstützte eine maximale Fotogröße von 1600 x 1600 Pixel. Bei „Fotos einfügen (neu)“ werden Größen bis zu 4.800 × 4.800 Pixel unterstützt.
Änderung zu Fotoreferenzen
Die Ortsfotos (Neu) API erfordert, dass Sie den Ressourcennamen des angeforderten Fotos angeben, der eine Orts-ID und die Fotoreferenz in folgender Form enthält:
https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY
Die Funktionen „Suche in der Nähe (Neu)“, „Textsuche (Neu)“ und „Ortsdetails (Neu)“ 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— Eine Zeichenkette, die den Ressourcennamen des Fotos enthält. Diese Zeichenkette hat folgendes 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 alten API müssen Sie nur die Fotoreferenz in folgender Form übergeben:
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— Eine Zeichenkette, die zur Identifizierung des Fotos bei einer Fotoanfrage verwendet wird.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.