Method: places.photos.getMedia

Ruft ein Fotomedium mit einem Fotoreferenzstring 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 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}. Fügen Sie am Ende der Fotoressource /media an, um den Namen der Fotomedienressource zu erhalten.

Abfrageparameter

Parameter
maxWidthPx

integer

Optional. Gibt die maximal gewünschte Breite 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 ist, 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 ist, 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 Fotos im Format places/{placeId}/photos/{photo_reference}/media.
photoUri

string

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

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform