Place Photos (alte Version)

„Place Photos (Legacy)“ ist Teil der Places API und eine schreibgeschützte API, mit der Sie Ihrer Anwendung hochwertige Fotos hinzufügen können. Mit Place Photos (Legacy) 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“ (Legacy)-, „Nearby Search“ (Legacy)- und „Text Search“ (Legacy)-Anfragen wird, falls relevant, auch eine einzelne Fotoreferenz pro Ort zurückgegeben. Mit Place Photos (Legacy) können Sie auf die referenzierten Fotos zugreifen und die Größe des Bildes auf die für Ihre Anwendung optimale Größe anpassen.

„Place Photos“-Anfragen (Legacy)

Eine Place Photos-Anfrage (Legacy) ist eine HTTP-URL im folgenden Format:

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. Die Liste der Parameter und ihrer möglichen Werte finden Sie unten.

Erforderliche Parameter

• photo_reference

  Eine String-Kennung, die ein Foto eindeutig identifiziert. Fotoreferenzen werden entweder bei einer Place Search- oder einer Place Details-Anfrage zurückgegeben.

• maxheight oder maxwidth

  maxheight gibt die maximale bevorzugte Höhe des Bildes in Pixeln an. Wenn das Bild kleiner als die angegebenen Werte ist, wird das Originalbild zurückgegeben. Wenn das Bild in einer der beiden Dimensionen größer ist, wird es so skaliert, dass es der kleineren der beiden Dimensionen entspricht, wobei das ursprüngliche Seitenverhältnis beibehalten wird.

  maxwidth gibt die maximale bevorzugte Breite des Bildes in Pixeln an. Wenn das Bild kleiner als die angegebenen Werte ist, wird das Originalbild zurückgegeben. Wenn das Bild in einer der beiden Dimensionen größer ist, wird es so skaliert, dass es der kleineren der beiden Dimensionen entspricht, wobei das ursprüngliche Seitenverhältnis beibehalten wird.

  Sowohl für das Attribut maxheight als auch für das Attribut maxwidth kann eine Ganzzahl zwischen 1 und 1600 angegeben werden.

  Sie müssen entweder maxheight oder maxwidth oder beides angeben.

Fotoreferenzen

Alle Anfragen an Place Photos (Legacy) müssen eine photo_reference enthalten, die 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 das Feld photos[], wenn für den Ort zugehörige Fotos vorhanden sind.

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

• Bei einer „Find Place (Legacy)“-, „Nearby Search (Legacy)“- oder „Text Search (Legacy)“-Anfrage wird im Array maximal ein photo-Element zurückgegeben.
• 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) zurückgegebenen 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 (alt)

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 Place Photos (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:

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, senden 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.