Method: places.photos.getMedia

Obtenir un support 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 support photo au format 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 la ressource multimédia.

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 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 nombre entier compris entre 1 et 4 800 inclus. Si la valeur n'est pas comprise dans la plage autorisée, une erreur INVALID_ARGUMENT sera renvoyée.

Vous devez spécifier au moins l'un des paramètres maxHeightPx et 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 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 nombre entier compris entre 1 et 4 800 inclus. Si la valeur n'est pas comprise dans la plage autorisée, une erreur INVALID_ARGUMENT sera renvoyée.

Vous devez spécifier au moins l'un des paramètres maxHeightPx et 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 règle n'est pas configurée, une redirection HTTP est émise pour rediriger l'appel vers l'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

Un mé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 pouvant être utilisé pour afficher la photo.