Zu Place Photo migrieren (Neu)

Die Places API unterstützt Place Photo (Legacy). Wenn Sie mit „Place Photo (Legacy)“ vertraut sind, sind bei Place Photo (New) die folgenden Änderungen zu beachten:

  • Für „Ortsfoto (neu)“ 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.
  • „Place Photo (New)“ unterstützt sowohl API-Schlüssel als auch OAuth als Authentifizierungsmechanismus.

In der folgenden Tabelle sind Parameter in „Ortsfoto (alt)“ aufgeführt, die für „Ortsfoto (neu)“ 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öße der Fotos wurde erhöht

Die maximale Fotogröße für „Ortsfotos (alt)“ betrug 1.600 × 1.600 Pixel. „Ortsfoto (neu)“ unterstützt Größen bis zu 4.800 × 4.800 Pixel.

Zu Bildreferenzen wechseln

Für die Place Photo API (neu) müssen Sie den Ressourcennamen des angeforderten Fotos mit einer Orts-ID und der Fotoreferenz im folgenden Format übergeben:

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 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 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.

Mit der vorhandenen 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“ (alt), „Nearby Search“ (alt), „Text Search“ (alt) und „Place Details“ (alt) geben in der Antwort ein photos[]-Array zurück, das dieses Format unterstützt. Jedes photo-Element in der alten Antwort enthält die folgenden Felder:

  • photo_reference: Ein String, der zum Identifizieren des Fotos bei einer Fotoanfrage verwendet wird.
  • 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.