Place Photos

Plattform auswählen: Android iOS JavaScript Webdienst

<ph type="x-smartling-placeholder">

Der Place Photo-Dienst, der Teil der Places API ist, mit der Sie Fotos und Videos in hoher Qualität zu Ihrem . Der „Place Photo“-Dienst bietet Zugriff auf Millionen von Fotos. die in der Places-Datenbank gespeichert sind. Wenn Sie Ortsinformationen über einen Ort abrufen Detailanfrage, bei relevanten Fotos werden Fotoreferenzen zurückgegeben Inhalte. Bei „Find Place“-, „Nearby Search“- und „Text Search“-Anfragen wird ebenfalls ein einzelnes Foto zurückgegeben. Referenz pro Ort, falls relevant. Mit dem Fotodienst können Sie dann auf die referenzierten Fotos und passen Sie die Größe an die optimale Größe für Ihr .

Place Photo-Anfragen

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. Standard In URLs werden alle Parameter durch ein Et-Zeichen (&) getrennt. Die Eine Liste der Parameter und ihrer möglichen Werte finden Sie unten.

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 Place Photo-Dienst müssen eine photo_reference, wird in der Antwort auf „Find Place“, „Nearby Search“, „Text Search“ oder „Place Details“ zurückgegeben Die Antwort auf diese Anfragen enthält das Feld photos[], wenn der Ort hat ähnliche fotografische Inhalte.

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

  • Eine „Find Place“-, „Nearby Search“- oder „Text Search“-Anfrage gibt höchstens ein photo-Element zurück im Array.
  • Bei „Place Details“-Anfragen werden bis zu zehn 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 Fotoanforderung aus.
  • height: Die maximale Höhe des Bildes.
  • width: Die maximale Breite des Bildes.
  • html_attributions[]: enthält alle erforderlichen Quellenangaben. Dieses ist immer vorhanden, kann aber leer sein.

Vom Fotodienst zurückgegebene Fotos stammen aus verschiedenen Quellen, z. B. von Geschäftsinhabern und von Nutzern erstellten Fotos. In den meisten Fällen Fotos können ohne Namensnennung verwendet werden oder verfügen über die erforderliche Namensnennung. als Teil des Bildes enthalten sind. Wenn das zurückgegebene photo-Element einen Wert im Feld html_attributions enthält, müssen Sie den Parameter zusätzliche Attribution in Ihrer Anwendung, wo immer Sie das Bild anzeigen.

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 Array photos[] in der Antwort.

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

Beispiel für ein Ortsfoto

Im Folgenden finden Sie ein Beispiel für eine Anforderung. Diese Anfrage gibt den Verweis zurück, -Bild und verändere die Größe so, dass sie höchstens 400 Pixel breit ist.

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

Ortsfotoantwort

Die Antwort auf eine erfolgreiche Ortsfotoanforderung ist ein Bild. Die Art der das Bild hängt vom Typ des ursprünglich eingereichten Fotos ab.

Wenn Ihre Anfrage Ihr verfügbares Kontingent überschreitet, gibt der Server eine HTTP 403-Status und zeigen Sie mit dem Bild unten an, dass das Kontingent überschritten:

Bild „Kontingent überschritten“

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

  • Der eingereichte Fotoverweis wurde nicht richtig angegeben.
  • Die Anfrage enthielt weder maxwidth noch maxheight Parameter.
  • Der Wert für den Parameter maxwidth oder maxheight wurde festgelegt an null.
  • photo_reference ist abgelaufen. Wenn die photo_reference abläuft, Anfrage an Place Details, Find Place, Nearby Search, oder Text Search um den aktualisierten Wert für photo_reference zu erhalten.