Place Photos

Plattform auswählen: Android iOS JavaScript Webdienst

Der „Place Photos“-Dienst ist Teil der Places API und eine API nur zum Lesen, mit der Sie Ihrer Anwendung hochwertige fotografische Inhalte hinzufügen können. Mit dem Fotodienst für Orte können Sie auf Millionen von Fotos in der Places-Datenbank zugreifen. Wenn Sie über eine „Place Details“-Anfrage Informationen zum Ort abrufen, erhalten Sie Fotoreferenzen zu relevanten Fotos. Bei „Find Place“-, „Nearby Search“- und „Text Search“-Anfragen wird, falls relevant, auch eine einzelne Fotoreferenz pro Ort zurückgegeben. Über den Fotodienst können Sie dann auf die referenzierten Fotos zugreifen und die Größe des Bildes auf die für Ihre Anwendung optimale Größe anpassen.

Anfragen für Fotos von Orten

Eine Ortsfotoanforderung ist eine HTTP-URL der folgenden Form:

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

Zum Initiieren einer Suchanfrage sind bestimmte Parameter erforderlich. Wie in URLs üblich, werden alle Parameter mit dem Und-Zeichen (&) getrennt. Unten finden Sie eine Liste der Parameter und ihrer möglichen Werte.

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 den Dienst „Place Photo“ müssen eine photo_reference enthalten, die in der Antwort auf eine „Find Place“, „Nearby Search“, „Text Search“ oder „Place Details“-Anfrage zurückgegeben wird. Die Antwort auf diese Anfragen enthält ein photos[]-Feld, wenn es für den Ort entsprechende Fotos gibt.

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

  • Bei einer „Find Place“, „Nearby Search“ oder „Text Search“-Anfrage ist maximal ein photo-Element im Array enthalten.
  • Bei einer „Place Details“-Anfrage werden bis zu zehn photo-Elemente zurückgegeben.

Jedes photo-Element 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[]: Enthält alle erforderlichen Quellenangaben. Dieses Feld ist immer vorhanden, kann aber leer sein.

Die vom Fotodienst 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 Zuordnung immer dann in Ihre Anwendung einbinden, wenn das Bild zu sehen ist.

Das folgende Beispiel zeigt eine „Place Details“-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.

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

Beispiel für ein Place Photo

Im Folgenden finden Sie ein Beispiel für eine Anforderung. Bei dieser Anfrage wird das referenzierte Bild zurückgegeben und so skaliert, 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 für Place Photo

Die Antwort auf eine erfolgreiche Place Photo-Anfrage ist ein Bild. Der Bildtyp hängt vom Typ des ursprünglich eingereichten Fotos ab.

Wenn Ihre Anfrage das verfügbare Kontingent überschreitet, gibt der Server den Status HTTP 403 zurück und zeigt das folgende Bild an, um anzuzeigen, dass das Kontingent überschritten wurde:

Bild für überschrittenes Kontingent

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

  • 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, senden Sie eine Anfrage an Place Details, Find Place, Nearby Search oder Text Search, um den aktualisierten Wert für photo_reference zu erhalten.