Photos du lieu

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.
Sélectionnez une plate-forme : Android iOS JavaScript Service Web

Le service Place Photo, qui fait partie de l'API Places, est une API en lecture seule qui vous permet d'ajouter du contenu photographique de haute qualité à votre application. Le service Place Photo vous donne accès aux millions de photos stockées dans la base de données Places. Lorsque vous obtenez des informations sur un lieu à l'aide d'une requête Places Details, des références photo sont renvoyées pour le contenu photographique pertinent. Les requêtes Find Place, Nearby Search et Text Search renvoient également une seule référence photo par lieu, le cas échéant. Le service Photo vous permet ensuite d'accéder aux photos référencées et de redimensionner l'image à la taille optimale pour votre application.

Requêtes Place Photo

Une requête de photos de lieu est une URL HTTP utilisant le format suivant :

https://maps.googleapis.com/maps/api/place/photo?parameters

Certains paramètres sont obligatoires pour lancer une requête de recherche. Comme pour les URL, tous les paramètres sont séparés par une esperluette (&). La liste des paramètres et leurs valeurs possibles sont énumérées ci-dessous.

Required parameters

  • photo_reference

    A string identifier that uniquely identifies a photo. Photo references are returned from either a Place Search or Place Details request.

Optional parameters

  • maxheight

    Specifies the maximum desired height, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio. Both the maxheight and maxwidth properties accept an integer between 1 and 1600.

  • maxwidth

    Specifies the maximum desired width, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio. Both the maxheight and maxwidth properties accept an integer between 1 and 1600.

Generated from the OpenAPI specification. Edit Report bug

Références photo

Toutes les requêtes envoyées au service Place Photo doivent inclure un photoreference, renvoyé en réponse à une requête Find Place, Nearby Search, Text Search ou Place Details. La réponse à ces requêtes contient un champ photos[] si le lieu comporte du contenu photographique associé.

Remarque:Le nombre de photos renvoyées varie selon les demandes.

  • Une requête Find Place, Nearby Search ou Text Search renvoie au maximum un élément photo du tableau.
  • Une requête Places Details renvoie jusqu'à 10 éléments photo.

Chaque élément photo contient les champs suivants:

  • photo_reference : chaîne permettant d'identifier la photo lorsque vous exécutez une requête Photo.
  • height : hauteur maximale de l'image.
  • width : largeur maximale de l'image.
  • html_attributions[] : contient les attributions requises. Ce champ est toujours présent, mais peut être vide.

Les photos renvoyées par le service Photos proviennent de divers lieux, y compris des propriétaires d'établissement et des photos fournies par les utilisateurs. Dans la plupart des cas, ces photos peuvent être utilisées sans mention d'attribution ou comporter l'attribution requise dans l'image. Toutefois, si l'élément photo renvoyé inclut une valeur dans le champ html_attributions, vous devez inclure l'attribution supplémentaire dans votre application, partout où vous affichez l'image.

Vous trouverez ci-dessous un exemple de tableau photos[].

...
"photos" : [
   {
      "html_attributions" : [],
      "height" : 853,
      "width" : 1280,
      "photo_reference" : "CnRvAAAAwMpdHeWlXl-lH0vp7lez4znKPIWSWvgvZFISdKx45AwJVP1Qp37YOrH7sqHMJ8C-vBDC546decipPHchJhHZL94RcTUfPa1jWzo-rSHaTlbNtjh-N68RkcToUCuY9v2HNpo5mziqkir37WU8FJEqVBIQ4k938TI3e7bf8xq-uwDZcxoUbO_ZJzPxremiQurAYzCTwRhE_V0"
   }
...

Exemple de photo de lieu

Voici un exemple de requête. Cette requête renvoie l'image référencée en la redimensionnant de sorte qu'elle ne dépasse pas 400 pixels de large.

https://maps.googleapis.com/maps/api/place/photo
  ?maxwidth=400
  &photo_reference=Aap_uEA7vb0DDYVJWEaX3O-AtYp77AaswQKSGtDaimt3gt7QCNpdjp1BkdM6acJ96xTec3tsV_ZJNL_JP-lqsVxydG3nh739RE_hepOOL05tfJh2_ranjMadb3VoBYFvF0ma6S24qZ6QJUuV6sSRrhCskSBP5C1myCzsebztMfGvm7ij3gZT
  &key=YOUR_API_KEY

Réponse à une photo de lieu

La réponse à une requête de photos de lieu valide est une image. Le type de l'image dépend du type de la photo envoyée à l'origine.

Si votre requête dépasse votre quota disponible, le serveur renvoie un état HTTP 403 et affiche l'image ci-dessous pour indiquer que le quota a été dépassé:

Image de dépassement de quota

Si le serveur ne parvient pas à comprendre votre requête, il renvoie l'état HTTP 400, ce qui indique une requête non valide. Voici les raisons les plus courantes des requêtes non valides:

  • La référence de photo envoyée n'a pas été spécifiée correctement.
  • La requête n'incluait pas les paramètres maxwidth ni maxheight.
  • La valeur du paramètre maxwidth ou maxheight a été définie sur null.