Method: places.photos.getMedia

Permet d'obtenir un support photo avec une chaîne de référence de 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 support photo au format places/{placeId}/photos/{photo_reference}/media.

Le nom de 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 de support photo.

Paramètres de requête

Paramètres
maxWidthPx

integer

Facultatif. Spécifie 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 ou l'autre des dimensions, elle sera mise à l'échelle pour correspondre à la plus petite des deux dimensions, dans la limite de ses proportions d'origine. Les propriétés maxHeightPx et maxWidthPx acceptent un entier compris entre 1 et 4 800 inclus. Si la valeur n'est pas comprise 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 n'est spécifié, une erreur INVALID_ARGUMENT est renvoyée.

maxHeightPx

integer

Facultatif. Spécifie 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 sera mise à l'échelle pour correspondre à la plus petite des deux dimensions, dans la limite de ses proportions d'origine. Les propriétés maxHeightPx et maxWidthPx acceptent un entier compris entre 1 et 4 800 inclus. Si la valeur n'est pas comprise 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 n'est spécifié, une erreur INVALID_ARGUMENT est renvoyée.

skipHttpRedirect

boolean

Facultatif. Si cette valeur 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 règle n'est pas configurée, une redirection HTTP est émise pour rediriger l'appel vers le support image. Cette option est ignorée pour les requêtes autres que HTTP.

Corps de la requête

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

Corps de la réponse

Contenu multimédia 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 support photo au format places/{placeId}/photos/{photo_reference}/media.

photoUri

string

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