Zu „Place Photos“ (neu) migrieren

Entwickler im Europäischen Wirtschaftsraum (EWR)

Einführung

Die Places API unterstützt Place Photos (Legacy). Wenn Sie mit Place Photos (Legacy) vertraut sind, beachten Sie, dass Place Photos (New) die folgenden Änderungen mit sich bringt:

  • Bei „Place Photos (New)“ müssen Sie den Ressourcennamen des Fotos übergeben, der die Orts-ID in der Anfrage-URL enthält, und nicht nur den Fotoverweis. Weitere Informationen finden Sie unter Änderung bei Fotoreferenzen.
  • Place Photos (New) unterstützt sowohl API-Schlüssel als auch OAuth als Authentifizierungsmechanismus.

In der folgenden Tabelle sind 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.

Größere Fotos

Place Photos (Legacy) unterstützte eine maximale Fotogröße von 1600 × 1600 Pixeln. Place Photos (New) unterstützt Größen bis zu 4.800 × 4.800 Pixel.

Zu Fotoreferenzen wechseln

Für die Place Photos (New) API müssen Sie den Ressourcennamen des angeforderten Fotos übergeben. Dieser enthält eine Orts-ID und den Fotoverweis im folgenden Format:

https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY

Bei „Nearby Search (New)“, „Text Search (New)“ und „Place Details (New)“ wird in der Antwort ein photos[]-Array zurückgegeben, 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 Bildes in Pixeln.
  • widthPx: Die maximale Breite des Bildes in Pixeln.
  • authorAttributions[]: Alle erforderlichen Quellenangaben. Dieses Feld ist immer vorhanden, kann aber leer sein.

Bei der alten API müssen Sie nur die Fotoreferenz im folgenden Format übergeben:

https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY

Bei „Find Place (Legacy)“, „Nearby Search (Legacy)“, „Text Search (Legacy)“ und „Place Details (Legacy)“ wird in der Antwort ein photos[]-Array zurückgegeben, 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 Bildes.
  • width: Die maximale Breite des Bildes.
  • html_attributions[]: Alle erforderlichen Quellenangaben. Dieses Feld ist immer vorhanden, kann aber leer sein.