Method: places.photos.getMedia

Obtenez un contenu multimédia photo avec une chaîne de référence photo.

Requête HTTP

GET https://places.googleapis.com/v1/{name=places/*/photos/*/media}

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Obligatoire. Nom de ressource d'un élément multimédia photo au format suivant : places/{placeId}/photos/{photo_reference}/media.

Le nom de ressource d'une photo tel qu'il est renvoyé dans le champ photos.name d'un objet Place est au format places/{placeId}/photos/{photo_reference}. Vous devez ajouter /media à la fin de la ressource photo pour obtenir le nom de ressource du contenu multimédia de la photo.

Paramètres de requête

Paramètres
maxWidthPx

integer

Facultatif. Spécifie la largeur maximale souhaitée de l'image, en pixels. Si l'image est plus petite que les valeurs spécifiées, l'image d'origine est renvoyée. Si l'image est plus grande dans l'une ou l'autre dimension, elle sera mise à l'échelle pour correspondre à la plus petite des deux dimensions, tout en conservant son format d'origine. Les propriétés maxHeightPx et maxWidthPx acceptent un entier compris entre 1 et 4 800, inclus. Si la valeur ne se trouve pas dans la plage autorisée, une erreur INVALID_ARGUMENT est renvoyée.

Vous devez spécifier au moins maxHeightPx ou maxWidthPx. Si ni maxHeightPx ni maxWidthPx ne sont spécifiés, une erreur INVALID_ARGUMENT est renvoyée.
maxHeightPx

integer

Facultatif. Spécifie la hauteur maximale souhaitée de l'image, en pixels. Si l'image est plus petite que les valeurs spécifiées, l'image d'origine est renvoyée. Si l'image est plus grande dans l'une ou l'autre dimension, elle sera mise à l'échelle pour correspondre à la plus petite des deux dimensions, tout en conservant son format d'origine. Les propriétés maxHeightPx et maxWidthPx acceptent un entier compris entre 1 et 4 800, inclus. Si la valeur ne se trouve pas dans la plage autorisée, une erreur INVALID_ARGUMENT est renvoyée.

Vous devez spécifier au moins maxHeightPx ou maxWidthPx. Si ni maxHeightPx ni maxWidthPx ne sont spécifiés, une erreur INVALID_ARGUMENT est renvoyée.
skipHttpRedirect

boolean

Facultatif. Si cette option est définie, ignorez le comportement de redirection HTTP par défaut et affichez une réponse au format texte (par exemple, au format JSON pour le cas d'utilisation HTTP). Si elle n'est pas définie, une redirection HTTP est émise pour rediriger l'appel vers le contenu multimédia de l'image. Cette option est ignorée pour les requêtes non HTTP.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Photo provenant de l'API Places.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "name": string,
  "photoUri": string
}
Champs
name

string

Nom de ressource d'un élément multimédia photo au format suivant : places/{placeId}/photos/{photo_reference}/media.
photoUri

string

URI à courte durée de vie qui peut être utilisé pour afficher la photo.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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