Fotos zum Ort

Plattform auswählen: Android iOS JavaScript Webdienst

Der Place Photo-Dienst der Places API ist eine schreibgeschützte API, mit der Sie Ihrer Anwendung hochwertige fotografische Inhalte hinzufügen können. Mit dem Place Photo-Dienst können Sie auf Millionen von Fotos in der Places-Datenbank zugreifen. Wenn Sie Ortsdetails über eine „Place Details“-Anfrage abrufen, werden Fotoverweise für relevante fotografische Inhalte zurückgegeben. Bei „Find Place“-, „Nearby Search“- und „Text Search“-Anfragen wird gegebenenfalls auch eine einzige Fotoreferenz pro Ort zurückgegeben. Mit dem Fotodienst können Sie dann auf die referenzierten Fotos zugreifen und das Bild auf die optimale Größe für Ihre Anwendung skalieren.

Ortsfotoanfragen

Eine Ortsfotoanforderung ist eine HTTP-URL der folgenden Form:

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

Es sind bestimmte Parameter für die Initiierung einer Suchanforderung erforderlich. Wie bei URLs üblich, werden alle Parameter durch das kaufmännische Und-Zeichen (&) getrennt. Die Liste der Parameter und ihrer möglichen Werte sind 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 den „Place Photo“-Dienst müssen ein photo_reference enthalten, das als Antwort auf eine „Find Place“-, „Nearby Search“-, „Text Search“- oder „Place Details“-Anfrage zurückgegeben wird. Die Antwort auf diese Anfragen enthält das Feld photos[], wenn der Ort entsprechende fotografische Inhalte hat.

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

  • Bei einer „Find Place“-, „Nearby Search“- oder „Text Search“-Anfrage wird maximal ein photo-Element im Array zurückgegeben.
  • 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, mit dem das Foto bei einer Fotoanfrage identifiziert wird.
  • height: Die maximale Höhe des Bildes.
  • width: Die maximale Breite des Bildes.
  • html_attributions[]: enthält alle erforderlichen Zuordnungen. Dieses Feld ist immer vorhanden, kann aber leer sein.

Vom Fotodienst zurückgegebene Fotos stammen aus verschiedenen Quellen, z. B. von Geschäftsinhabern und von Nutzern beigesteuerten Fotos. In den meisten Fällen können diese Fotos ohne Quellenangabe verwendet werden bzw. sind die erforderlichen Quellenangaben bereits im Bild enthalten. Wenn das zurückgegebene photo-Element jedoch einen Wert im Feld html_attributions enthält, müssen Sie überall dort, wo das Bild angezeigt wird, die zusätzliche Attribution in Ihre Anwendung einfügen.

Unten sehen Sie ein Beispiel für ein photos[]-Array.

...
"photos" : [
   {
      "html_attributions" : [],
      "height" : 853,
      "width" : 1280,
      "photo_reference" : "AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1"
   }
...

Beispiel für ein Ortsfoto

Nachfolgend finden Sie ein Beispiel für eine Anforderung. Diese Anfrage gibt das referenzierte Bild zurück und passt seine Größe so an, dass es höchstens 400 Pixel breit ist.

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1&key=YOUR_API_KEY

Ortsfotoantwort

Die Antwort auf eine erfolgreiche Ortsfotoanforderung ist ein Bild. Die Art des Bildes 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 die folgende Abbildung an, die darauf hinweist, dass das Kontingent überschritten wurde:

Bild: Kontingent überschritten

Wenn der Server Ihre Anfrage nicht verarbeiten kann, gibt er den HTTP 400-Status 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.