Der Place Photo-Dienst, der Teil der Places API ist, ist eine schreibgeschützte API, mit der Sie Ihrer Anwendung qualitativ hochwertige fotografische Inhalte hinzufügen können. Mit dem „Place Photo“-Dienst können Sie auf die Millionen von Fotos in der Places-Datenbank zugreifen. Wenn Sie Ortsinformationen ü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 außerdem, falls relevant, eine einzige Fotoreferenz pro Ort zurückgegeben. Mit dem Fotodienst können Sie dann auf die referenzierten Fotos zugreifen und das Bild an die für Ihre Anwendung optimale Größe anpassen.
Place Photo-Anfragen
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 ein Et-Zeichen (&
) getrennt. Im Folgenden 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
andmaxwidth
properties accept an integer between1
and1600
.You must specify either
maxheight
, ormaxwidth
, or both.
Fotoreferenzen
Alle Anfragen an den Place Photo-Dienst 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 das Feld photos[]
, wenn der Ort entsprechende fotografische Inhalte hat.
Hinweis: Die Anzahl der zurückgegebenen Fotos hängt von der Anfrage ab.
- Bei Anfragen vom Typ „Find Place“, „Nearby Search“ oder „Text Search“ wird maximal ein
photo
-Element im Array zurückgegeben. - 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 Fotoanfrage ausführen.height
: Die maximale Höhe des Bildes.width
: Die maximale Breite des Bildes.html_attributions[]
: enthält alle erforderlichen Quellenangaben. Dieses Feld ist immer vorhanden, kann aber leer sein.
Die vom Fotodienst zurückgegebenen Fotos stammen aus verschiedenen Quellen, z. B. von Geschäftsinhabern oder Nutzern. 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 die zusätzliche Attribution überall dort, wo das Bild zu sehen ist, in Ihre App einfügen.
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
Nachfolgend finden Sie ein Beispiel für eine Anforderung. Diese Anfrage gibt das referenzierte Bild zurück und ändert seine Größe so, dass es 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 des Bildes hängt vom Typ des ursprünglich eingereichten Fotos ab.
Wenn Ihre Anfrage das verfügbare 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 verstehen kann, gibt er den HTTP-Status 400 zurück. Dies weist auf eine ungültige Anfrage hin. Dies sind die häufigsten Gründe für eine ungültige Anfrage:
- Der eingereichte Fotoverweis wurde nicht richtig angegeben.
- Die Anfrage enthielt weder den Parameter
maxwidth
noch den Parametermaxheight
. - Der Wert für den Parameter
maxwidth
odermaxheight
wurde aufnull
festgelegt. photo_reference
ist abgelaufen. Wennphoto_reference
abläuft, senden Sie eine Anfrage an Place Details, Find Place, Nearby Search oder Text Search, um den aktualisiertenphoto_reference
-Wert zu erhalten.