Place Photos (alte Version)

Entwickler im Europäischen Wirtschaftsraum (EWR)

Place Photos (Legacy), ein Teil der Places API, ist eine schreibgeschützte API, mit der Sie Ihrer Anwendung hochwertige fotografische Inhalte hinzufügen können. Mit Place Photos (Legacy) erhalten Sie Zugriff auf die Millionen von Fotos, die in der Places-Datenbank gespeichert sind. Wenn Sie über eine Anfrage nach Ortsdetails Informationen zu einem Ort erhalten, werden Ihnen bei relevantem fotografischen Inhalt auch Fotoreferenzen angezeigt. Die Anfragen Find Place (Legacy), Nearby Search (Legacy) und Text Search (Legacy) liefern, sofern relevant, auch eine einzelne Fotoreferenz pro Ort zurück. Mit Place Photos (Legacy) können Sie auf die referenzierten Fotos zugreifen und das Bild auf die für Ihre Anwendung optimale Größe skalieren.

Ortsfotos (Legacy)-Anfragen

Eine Anfrage für Ortsfotos (Legacy) ist eine HTTP-URL folgender Form:

https://maps.googleapis.com/maps/api/place/photo?parameters

Zum Initiieren einer Suchanfrage sind bestimmte Parameter erforderlich. Wie bei URLs üblich, werden alle Parameter durch das kaufmännische Und-Zeichen (&) getrennt. Die Liste der Parameter und ihrer möglichen Werte ist unten aufgeführt.

Required parameters

  • photo_reference

    A string identifier that uniquely identifies a photo. Photo references are returned from either a Place Search or Place Details request.

  • maxheight or maxwidth

    maxheight specifies the maximum desired height, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio.

    maxwidth specifies the maximum desired width, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio.

    Both the maxheight and maxwidth properties accept an integer between 1 and 1600.

    You must specify either maxheight, or maxwidth, or both.

Fotoreferenzen

Alle Anfragen an Place Photos (Legacy) müssen ein photo_reference enthalten, das in der Antwort auf eine Find Place (Legacy), Nearby Search (Legacy), Text Search (Legacy) oder Place Details (Legacy) Anfrage zurückgegeben wird. Die Antwort auf diese Anfragen enthält ein Feld photos[], wenn der Ort über entsprechende fotografische Inhalte verfügt.

Hinweis: Die Anzahl der zurückgegebenen Fotos hängt von der Anfrage ab.

  • Eine Anfrage vom Typ Find Place (Legacy), Nearby Search (Legacy) oder Text Search (Legacy) gibt höchstens ein photo-Element im Array zurück.
  • Bei einer Place Details (Legacy)-Anfrage werden bis zu 10 photo-Elemente zurückgegeben.

Jedes photo-Element enthält die folgenden Felder:

  • photo_reference: Ein String, mit dem das Foto identifiziert wird, wenn Sie eine „Place Photos (Legacy)“-Anfrage stellen.
  • height – die maximale Höhe des Bilds.
  • width – die maximale Breite des Bildes.
  • html_attributions[]: Enthält alle erforderlichen Quellenangaben. Dieses Feld ist immer vorhanden, kann aber leer sein.

Die von Place Photos (Legacy) bereitgestellten Fotos stammen aus unterschiedlichen Quellen, z. B. von Geschäftsinhabern oder Nutzern. In den meisten Fällen dürfen diese Fotos ohne Quellenangabe verwendet werden bzw. sind die erforderlichen Zuordnungen bereits im Bild eingebunden. Wenn das zurückgegebene photo-Element jedoch einen Wert im Feld html_attributions enthält, müssen Sie die zusätzliche Quellenangabe immer dann in Ihre Anwendung einbinden, wenn das Bild zu sehen ist.

Das folgende Beispiel zeigt eine „Place Details (Legacy)“-Anfrage:

curl "https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJcUElzOzMQQwRLuV30nMUEUM&key=YOUR_API_KEY"

Unten sehen Sie ein Beispiel für das photos[]-Array in der Antwort.

    ...
    "photos" : [
       {
          "html_attributions" : [],
          "height" : 853,
          "width" : 1280,
          "photo_reference" : "ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q"
       }]
    ...

Beispiel für Place Photos (Legacy)

Im Folgenden finden Sie ein Beispiel für eine Anforderung. Diese Anfrage gibt das referenzierte Bild zurück und ändert seine Größe so, dass es maximal 400 Pixel breit ist.

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q&key=YOUR_API_KEY

Antwort zu Ortsfotos (Legacy)

Die Antwort auf eine erfolgreiche Place Photos-Anfrage (Legacy) ist ein Bild. Der Typ des Bildes hängt vom Typ des ursprünglich eingereichten Fotos ab.

Wenn Ihre Anfrage Ihr verfügbares Kontingent überschreitet, gibt der Server den HTTP-Statuscode 403 zurück und zeigt das folgende Bild an, um darauf hinzuweisen, dass das Kontingent überschritten wurde:

Bild „Kontingent überschritten“

Wenn der Server Ihre Anfrage nicht verarbeiten kann, gibt er den HTTP-Statuscode 400 zurück, der auf eine ungültige Anfrage hinweist. Dies sind die häufigsten Gründe für eine ungültige Anfrage:

  • Die eingereichte Fotoreferenz wurde nicht korrekt angegeben.
  • Die Anfrage enthielt weder den Parameter maxwidth noch den Parameter maxheight.
  • Der Wert für den Parameter maxwidth oder maxheight wurde auf null festgelegt.
  • photo_reference ist abgelaufen. Wenn photo_reference abläuft, stellen Sie eine Anfrage an Place Details (Legacy), Find Place (Legacy), Nearby Search (Legacy) oder Text Search (Legacy), um den aktualisierten photo_reference-Wert zu erhalten.