Places API unterstützt die bestehende Ortsfoto. Wenn Sie mit dem bereits vorhandenen Place Photo vertraut sind, wird das neue Version von Place Photo nimmt folgende Änderungen vor:
- Für den neuen Place Photo-Dienst müssen Sie übergeben Sie den Ressourcennamen des Fotos, der die Orts-ID im -Anforderungs-URL statt nur der Fotoreferenz. Weitere Informationen finden Sie unter Zu Fotoreferenzen wechseln
- Der neue Place Photo-Dienst unterstützt sowohl API-Schlüssel und OAuth als Authentifizierungsmechanismus.
In der folgenden Tabelle sind die Parameter der vorhandenen Ortsfoto, das für die eines neuen Ortsfotos oder Parameter, die nicht mehr unterstützt.
| Aktueller Parameter | Neuer Parameter | Hinweise |
|---|---|---|
maxheight |
maxHeightPx |
Sie müssen entweder maxHeightPx,
maxWidthPx oder beides. |
maxwidth |
maxWidthPx |
Sie müssen entweder maxHeightPx,
maxWidthPx oder beides. |
Fotos vergrößert
Das vorhandene Ortsfoto unterstützt die maximale Anzahl von Fotos. Größe von 1600 x 1600 Pixel. Ortsfoto (Neu) unterstützt Größen von bis zu 4.800 x 4.800 Pixeln.
Zu Fotoreferenzen ändern
Das neue Ortsfoto Für die API muss der Ressourcenname des angeforderten Fotos übergeben werden, eine Orts-ID und den Fotoverweis im folgenden Format enthält:
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“
Alle 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 der Foto. 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 ist immer vorhanden, kann aber leer sein.
Mit der vorhandenen API müssen Sie lediglich die Fotoreferenz im Feld Formular:
https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY
Das vorhandene Find Place,
Nearby Search, Text Search und
Bei „Place Details“-Anfragen wird ein photos[]-Array im
Antwort, die dieses Format unterstützt. Jedes photo-Element im vorhandenen
Antwort enthält die folgenden Felder:
photo_reference: Ein String, mit dem das Foto identifiziert werden kann, wenn Sie eine Fotoanforderung aus.height: Die maximale Höhe des Bildes.width: Die maximale Breite des Bilds.html_attributions[]: alle erforderlichen Quellenangaben. Dieses ist immer vorhanden, kann aber leer sein.