Method: places.photos.getMedia

• Requête HTTP
• Paramètres de chemin d'accès
• Paramètres de requête
• Corps de la requête
• Corps de la réponse
  • Représentation JSON

Récupérez 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 la ressource d'un contenu multimédia photo au format places/{placeId}/photos/{photo_reference}/media. Le nom de la ressource d'une photo 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 la ressource multimédia photo.

Paramètres de requête

Paramètres
maxWidthPx	integer Facultatif. Indique la largeur maximale souhaitée, en pixels, de l'image. 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 des dimensions, elle sera redimensionnée 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 l'une des valeurs maxHeightPx ou maxWidthPx. Si ni maxHeightPx ni maxWidthPx ne sont spécifiés, une erreur INVALID_ARGUMENT est renvoyée.
maxHeightPx	integer Facultatif. Indique la hauteur maximale souhaitée, en pixels, de l'image. 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 des dimensions, elle est mise à l'échelle pour correspondre à la plus petite des deux dimensions, dans un 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 l'une des valeurs 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 cette valeur n'est pas définie, une redirection HTTP est émise pour rediriger l'appel vers le support 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

Contenu multimédia photo 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 la ressource d'un contenu multimédia photo au format places/{placeId}/photos/{photo_reference}/media.
photoUri	string URI à courte durée de vie pouvant être utilisé pour afficher la photo.