Method: places.photos.getMedia

Ruft ein Fotomedium mit einer Fotoreferenzzeichenfolge ab.

HTTP-Anfrage

GET https://places.googleapis.com/v1/{name=places/*/photos/*/media}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Erforderlich. Der Ressourcenname eines Fotomediums im Format places/{placeId}/photos/{photo_reference}/media.

Der Ressourcenname eines Fotos, der im Feld photos.name eines Ortsobjekts zurückgegeben wird, hat das Format places/{placeId}/photos/{photo_reference}. Sie müssen /media an das Ende der Fotoressource anhängen, um den Namen der Fotomedienressource zu erhalten.

Abfrageparameter

Parameter
maxWidthPx

integer

Optional. Gibt die maximal gewünschte Breite des Bildes in Pixeln an. Wenn das Bild kleiner als die angegebenen Werte ist, wird das Originalbild zurückgegeben. Ist das Bild in beiden Abmessungen größer, wird es auf die kleinere der beiden Abmessungen unter Berücksichtigung des ursprünglichen Seitenverhältnisses skaliert. Die Eigenschaften „maxHeightPx“ und „maxWidthPx“ akzeptieren eine Ganzzahl zwischen 1 und 4.800 (jeweils einschließlich). Wenn der Wert nicht im zulässigen Bereich liegt, wird der Fehler INVALID_ARGUMENT zurückgegeben.

Es muss mindestens entweder maxHeightPx oder maxWidthPx angegeben werden. Wenn weder maxHeightPx noch maxWidthPx angegeben ist, wird der Fehler INVALID_ARGUMENT zurückgegeben.
maxHeightPx

integer

Optional. Gibt die maximal gewünschte Höhe des Bildes in Pixeln an. Wenn das Bild kleiner als die angegebenen Werte ist, wird das Originalbild zurückgegeben. Ist das Bild in beiden Abmessungen größer, wird es auf die kleinere der beiden Abmessungen unter Berücksichtigung des ursprünglichen Seitenverhältnisses skaliert. Die Eigenschaften „maxHeightPx“ und „maxWidthPx“ akzeptieren eine Ganzzahl zwischen 1 und 4.800 (jeweils einschließlich). Wenn der Wert nicht im zulässigen Bereich liegt, wird der Fehler INVALID_ARGUMENT zurückgegeben.

Es muss mindestens entweder maxHeightPx oder maxWidthPx angegeben werden. Wenn weder maxHeightPx noch maxWidthPx angegeben ist, wird der Fehler INVALID_ARGUMENT zurückgegeben.
skipHttpRedirect

boolean

Optional. Überspringen Sie in diesem Fall das standardmäßige HTTP-Weiterleitungsverhalten und rendern Sie eine Antwort im Textformat (z. B. im JSON-Format für HTTP-Anwendungsfall). Wenn die Richtlinie nicht konfiguriert ist, wird eine HTTP-Weiterleitung ausgegeben, um den Aufruf an die Bildmedien weiterzuleiten. Bei Nicht-HTTP-Anfragen wird diese Option ignoriert.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Ein Fotomedium aus der Places API

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "name": string,
  "photoUri": string
}
Felder
name

string

Der Ressourcenname eines Fotomediums im Format places/{placeId}/photos/{photo_reference}/media.
photoUri

string

Ein kurzlebiger URI, der zum Rendern des Fotos verwendet werden kann.