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 Fotos 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 Bilds 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. Sowohl für „maxHeightPx“ als auch für „maxWidthPx“ ist eine Ganzzahl zwischen 1 und 4.800 zulässig (einschließlich). Wenn der Wert nicht im zulässigen Bereich liegt, wird der Fehler INVALID_ARGUMENT zurückgegeben.

Es muss mindestens eine der beiden Optionen „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 Bilds in Pixeln an. Ist das Bild kleiner als die angegebenen Werte, wird das Originalbild zurückgegeben. Wenn das Bild in einer der beiden Dimensionen größer ist, wird es so skaliert, dass es der kleineren der beiden Dimensionen entspricht, wobei das ursprüngliche Seitenverhältnis beibehalten wird. Sowohl für „maxHeightPx“ als auch für „maxWidthPx“ ist eine Ganzzahl zwischen 1 und 4.800 zulässig. Wenn der Wert nicht im zulässigen Bereich liegt, wird der Fehler INVALID_ARGUMENT zurückgegeben.

Es muss mindestens eine der beiden Optionen „maxHeightPx“ oder „maxWidthPx“ angegeben werden. Wenn weder maxHeightPx noch maxWidthPx angegeben wird, wird der Fehler INVALID_ARGUMENT zurückgegeben.
skipHttpRedirect

boolean

Optional. Wenn diese Option festgelegt ist, wird das standardmäßige HTTP-Weiterleitungsverhalten übersprungen und eine Antwort im Textformat gerendert (z. B. im JSON-Format für den HTTP-Anwendungsfall). Wenn diese Option nicht festgelegt ist, wird eine HTTP-Weiterleitung erstellt, um den Aufruf an die Bildmedien weiterzuleiten. Diese Option wird für 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, der zum Rendern des Fotos verwendet werden kann.