Der Place Photo-Dienst, der Teil der Places API ist, ist eine schreibgeschützte API, mit der Sie qualitativ hochwertige Fotos in Ihre Anwendung einbinden können. Mit dem Place Photo-Dienst 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, nur eine Fotoreferenz pro Ort zurückgegeben. Mit dem Fotodienst können Sie auf die referenzierten Fotos zugreifen und das Bild auf die für Ihre Anwendung optimale Größe skalieren.
„Place Photo“-Anforderungen
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 in URLs üblich, werden alle Parameter mit dem Und-Zeichen (&
) getrennt. Die Liste der Parameter und ihre 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.
Optional parameters
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. Both the
maxheight
andmaxwidth
properties accept an integer between1
and1600
.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
.
Generated from the OpenAPI specification. Edit Report bug
Fotoreferenzen
Alle Anfragen an den Place Photo-Dienst müssen eine photoreference
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 zugehörige Fotoinhalte enthält.
Hinweis: Die Anzahl der zurückgegebenen Fotos hängt von der Anfrage ab.
- Eine „Find Place“, „Nearby Search“- oder „Text Search“-Anfrage gibt maximal ein
photo
-Element im Array zurück. - Eine Place Details-Anfrage gibt bis zu 10
photo
-Elemente zurück.
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 Zuordnungen. Dieses Feld ist immer vorhanden, aber möglicherweise leer.
Die vom Fotodienst bereitgestellten Fotos stammen aus unterschiedlichen 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 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.
Unten sehen Sie ein Beispiel für ein photos[]
-Array.
...
"photos" : [
{
"html_attributions" : [],
"height" : 853,
"width" : 1280,
"photo_reference" : "CnRvAAAAwMpdHeWlXl-lH0vp7lez4znKPIWSWvgvZFISdKx45AwJVP1Qp37YOrH7sqHMJ8C-vBDC546decipPHchJhHZL94RcTUfPa1jWzo-rSHaTlbNtjh-N68RkcToUCuY9v2HNpo5mziqkir37WU8FJEqVBIQ4k938TI3e7bf8xq-uwDZcxoUbO_ZJzPxremiQurAYzCTwRhE_V0"
}
...
Beispiel für ein Place Photo
Nachfolgend finden Sie ein Beispiel für eine Anforderung. Bei dieser Anfrage wird das Bild, auf das verwiesen wird, zurückgegeben und die Größe so angepasst, dass es maximal 400 Pixel breit ist.
https://maps.googleapis.com/maps/api/place/photo ?maxwidth=400 &photo_reference=Aap_uEA7vb0DDYVJWEaX3O-AtYp77AaswQKSGtDaimt3gt7QCNpdjp1BkdM6acJ96xTec3tsV_ZJNL_JP-lqsVxydG3nh739RE_hepOOL05tfJh2_ranjMadb3VoBYFvF0ma6S24qZ6QJUuV6sSRrhCskSBP5C1myCzsebztMfGvm7ij3gZT &key=YOUR_API_KEY
Place Photo-Antwort
Die Antwort auf eine erfolgreiche Ortsfotoanforderung ist ein Bild. Der Typ 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 das folgende Bild an, dass das Kontingent überschritten wurde:
Wenn der Server Ihre Anfrage nicht verstehen kann, gibt er den HTTP 400-Status zurück, was auf eine ungültige Anfrage hindeutet. Im Folgenden sind die häufigsten Gründe für ungültige Anfragen aufgeführt:
- Die angegebene Fotoreferenz wurde nicht korrekt angegeben.
- Die Anfrage enthielt weder die Parameter
maxwidth
nochmaxheight
. - Der Wert für den Parameter
maxwidth
odermaxheight
wurde aufnull
festgelegt.