Method: places.photos.getMedia

Fotomedien mit einem Fotoreferenzstring abrufen.

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 ist als die angegebenen Werte, 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 das ursprüngliche Seitenverhältnis beibehalten wird. Für die Eigenschaften „maxHeightPx“ und „maxWidthPx“ ist eine Ganzzahl zwischen einschließlich 1 und 4800 zulässig. Wenn der Wert nicht innerhalb des zulässigen Bereichs liegt, wird der Fehler INVALID_ARGUMENT zurückgegeben.

Es muss entweder maxHeightPx oder maxWidthPx angegeben werden. Wenn weder maxHeightPx noch maxWidthPx angegeben wird, 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 ist als die angegebenen Werte, 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 das ursprüngliche Seitenverhältnis beibehalten wird. Für die Eigenschaften „maxHeightPx“ und „maxWidthPx“ ist eine Ganzzahl zwischen einschließlich 1 und 4800 zulässig. Wenn der Wert nicht innerhalb des zulässigen Bereichs liegt, wird der Fehler INVALID_ARGUMENT zurückgegeben.

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

boolean

Optional. Wenn dieser Wert festgelegt ist, wird das standardmäßige HTTP-Weiterleitungsverhalten übersprungen und eine Antwort im Textformat gerendert (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. Diese Option wird bei Nicht-HTTP-Anfragen 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, mit dem das Foto gerendert werden kann.