Der Dienst Place Photo (New) ist eine schreibgeschützte API, mit der Sie Ihrer App 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“-, „Nearby Search“- oder „Text Search“-Anfrage abrufen, können Sie auch Fotoressourcen für relevante fotografische Inhalte anfordern. 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.
Mit dem API Explorer können Sie Live-Anfragen stellen, damit Sie sich mit der API und den API-Optionen vertraut machen können:
Testen!Place Photo-Anfragen
Eine Place Photo-Anfrage ist eine HTTP-GET-Anfrage an eine URL im folgenden Format:https://places.googleapis.com/v1/NAME/media?key=API_KEY&PARAMETERS
Folgende Parameter sind erforderlich:
- NAME enthält den Ressourcennamen des Fotos.
- API_KEY enthält den API-Schlüssel.
- PARAMETERS enthält entweder den Parameter
maxHeightPx
, den ParametermaxWidthPx
oder beides.
Die vollständige Liste der erforderlichen und optionalen Parameter wird nachfolgend beschrieben.
Erforderliche Parameter
Name des Fotos
Eine String-ID, die ein Foto eindeutig identifiziert. Fotonamen werden bei Anfragen vom Typ Place Details (New), Nearby Search (New) oder Text Search (New) in der Eigenschaft name
jedes Elements des Arrays photos[]
zurückgegeben.
Ein Beispiel finden Sie unter Namen eines Fotos eingeben.
maxHeightPx und maxWidthPx
Gibt die maximal gewünschte Höhe und Breite des Bildes in Pixeln an. Wenn das Bild kleiner als die angegebenen Werte ist, wird das Originalbild zurückgegeben. Ist das Bild in einer der beiden Abmessungen größer, wird es auf die kleinere der beiden Abmessungen skaliert, wobei es auf das ursprüngliche Seitenverhältnis beschränkt ist. Für die Properties „maxheight“ und „maxwidth“ ist eine Ganzzahl zwischen 1 und 4.800 zulässig.
Sie müssen entweder maxHeightPx
, maxWidthPx
oder beide angeben.
Optionale Parameter
skipHttpRedirect
Wenn false
(Standardeinstellung) ist, erstellen Sie eine HTTP-Weiterleitung zum Bild, um das Bild zurückzugeben.
Wenn true
, überspringen Sie die Weiterleitung und geben Sie eine JSON-Antwort mit den Bilddetails zurück.
Beispiel:
{ "name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/photos/Aaw_FcKly0DEv3EWmDJyHiEqXIP5mowOc99lN1GzBun6KHH52AZ5fFA/media", "photoUri": "https://lh3.googleusercontent.com/a-/AD_cFT-b=s100-p-k-no-mo" }
Diese Option wird bei Nicht-HTTP-Anfragen ignoriert.
Fotoname auswählen
Alle Anfragen an den „Place Photo“-Dienst müssen einen Fotoressourcennamen enthalten, der in der Antwort auf eine „Nearby Search“-, „Text Search“- oder „Place Details“-Anfrage zurückgegeben wird. Die Antwort auf diese Anfragen enthält ein photos[]
-Array, wenn der Ort ähnliche fotografische Inhalte hat.
Jedes Element von photo[]
enthält die folgenden Felder:
name
: Ein String, der den Ressourcennamen des Fotos enthält, wenn Sie eine Fotoanfrage ausführen. Diese Zeichenfolge hat das Format:places/PLACE_ID/photos/PHOTO_RESOURCE
heightPx
: Die maximale Höhe des Bildes in Pixeln.widthPx
: Die maximale Breite des Bildes in Pixeln.authorAttributions[]
: 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 authorAttributions
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, bei der photos
in der Feldmaske enthalten ist, sodass die Antwort das Array photos[]
in der Antwort enthält:
curl -X GET \ -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,photos" \ https://places.googleapis.com/v1/places/ChIJ2fzCmcW7j4AR2JzfXBBoh6EUnten sehen Sie ein Beispiel für ein
photos[]
-Array in der Antwort.
... "photos" : [ { "name": "places/ChIJ2fzCmcW7j4AR2JzfXBBoh6E/photos/AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1", "widthPx": 6000, "heightPx": 4000, "authorAttributions": [ { "displayName": "John Smith", "uri": "//maps.google.com/maps/contrib/101563", "photoUri": "//lh3.googleusercontent.com/a-/AD_cFT-b=s100-p-k-no-mo" } ] }, ...
Foto von Ort anfordern
In der folgenden Beispielanfrage wird ein Bild zurückgegeben, das seine Ressource name
verwendet und seine Größe so ändert, dass es höchstens 400 Pixel hoch und breit ist:
https://places.googleapis.com/v1/places/ChIJ2fzCmcW7j4AR2JzfXBBoh6E/photos/AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1/media?maxHeightPx=400&maxWidthPx=400&key=API_KEY
Die Antwort auf eine erfolgreiche Place Photo-Anfrage ist ein Bild. Die Art des Bildes hängt von der Art 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 Name des eingereichten Fotos wurde nicht richtig angegeben.
- Die Anfrage enthielt weder den Parameter
maxHeightPx
noch den ParametermaxWidthPx
. - Der Wert des Parameters
maxHeightPx
odermaxWidthtPx
wurde aufnull
festgelegt. name
ist abgelaufen. Wennname
abläuft, senden Sie eine Anfrage an Place Details (New), Nearby Search (New) oder Text Search (New), um eine neuename
zu erhalten.
Jetzt testen
Mit dem API Explorer können Sie Beispielanfragen stellen, um sich mit der API und den API-Optionen vertraut zu machen.
So stellen Sie eine Anfrage:
- Wählen Sie rechts auf der Seite das API-Symbol aus.
- Legen Sie den
name
-Parameter so fest:places/PLACE_ID/photos/PHOTO_RESOURCE/media
- Legen Sie
skipHttpRedirect
auftrue
fest, damit die Anfrage eine JSON-Antwort zurückgibt. Standardmäßig gibt die Anfrage das Bild zurück, das vom API Explorer nicht angezeigt werden kann. - Klicken Sie auf die Schaltfläche Execute (Ausführen). Wählen Sie im Pop-up-Fenster das Konto aus, das Sie für die Anfrage verwenden möchten.
Klicken Sie im Bereich „API Explorer“ auf das Symbol zum Maximieren (), um das API Explorer-Fenster zu maximieren.