Method: places.photos.getMedia

Ein Foto-Medium mit einem Foto-Referenzstring 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 Place-Objekts 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 Fotoressource zu erhalten.

Suchparameter

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. 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 Attribute „maxHeightPx“ und „maxWidthPx“ kann eine Ganzzahl zwischen 1 und 4800 (einschließlich) angegeben werden. Wenn der Wert nicht im zulässigen Bereich liegt, wird der Fehler INVALID_ARGUMENT zurückgegeben.

Es muss mindestens einer der Werte „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. 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 Attribute „maxHeightPx“ und „maxWidthPx“ kann eine Ganzzahl zwischen 1 und 4800 (einschließlich) angegeben werden. Wenn der Wert nicht im zulässigen Bereich liegt, wird der Fehler INVALID_ARGUMENT zurückgegeben.

Es muss mindestens einer der Werte „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 nicht festgelegt, wird eine HTTP-Weiterleitung ausgegeben, um den Aufruf an die Bildmedien weiterzuleiten. Diese Option wird für Nicht-HTTP-Anfragen ignoriert.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Ein Medienobjekt vom Typ „Foto“ 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.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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