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. Für die Eigenschaften "maxHeightPx" und "maxWidthPx" ist eine Ganzzahl zwischen einschließlich 1 und 4800 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. Für die Eigenschaften "maxHeightPx" und "maxWidthPx" ist eine Ganzzahl zwischen einschließlich 1 und 4800 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 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 Fotos im Format places/{placeId}/photos/{photo_reference}/media.
photoUri

string

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