Diese Seite wurde von der Cloud Translation API übersetzt.

Foto des Orts (neu)

Plattform auswählen: Android iOS Webdienst

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 Parameter maxWidthPx 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. Bei true können Sie die Weiterleitung überspringen und eine JSON-Antwort mit dem Image zurückgeben. 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.

Hinweis : Damit das photos[]-Array in die Antwort aufgenommen werden kann, muss die Feldmaske der Anfrage photos (Place Details) oder places.photos (Nearby Search und Text Search) enthalten. Mit jeder API können bis zu zehn Fotos für den Standort eines Orts zurückgegeben werden.

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/ChIJ2fzCmcW7j4AR2JzfXBBoh6E

Unten 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 Parameter maxWidthPx.
Der Wert des Parameters maxHeightPx oder maxWidthtPx wurde auf null festgelegt.
name ist abgelaufen. Wenn name abläuft, senden Sie eine Anfrage an Place Details (New), Nearby Search (New) oder Text Search (New), um eine neue name 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
```
Hinweis : Sie müssen name aus einer aktuellen „Place Details“-Anfrage verwenden, da name ablaufen kann.
Legen Sie skipHttpRedirect auf true 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.