Place Photos (ancienne version)

Place Photos (ancienne version), 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. Place Photos (ancienne version) vous donne accès à des 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 de Places Details, des références photo sont renvoyées pour le contenu photographique correspondant. Les requêtes Find Place (ancienne), Nearby Search (ancienne) et Text Search (ancienne) renvoient également une référence photo unique par lieu, le cas échéant. Place Photos (ancienne version) vous permet ensuite d'accéder aux photos référencées et de redimensionner l'image pour qu'elle s'adapte parfaitement à votre application.

Requêtes Place Photos (anciennes)

Une requête Place Photos (ancienne) est une URL HTTP au format suivant:

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

Certains paramètres sont obligatoires pour lancer une requête de recherche. Comme c'est la norme pour les URL, les différents 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.

  • maxheight or maxwidth

    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.

    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.

    You must specify either maxheight, or maxwidth, or both.

Références photo

Toutes les requêtes envoyées à Place Photos (ancienne version) doivent inclure un photo_reference, renvoyé dans la réponse à une requête Find Place (ancienne version), Nearby Search (ancienne version), Text Search (ancienne version) ou Place Details (ancienne version). La réponse à ces requêtes contiendra un champ photos[] si le lieu dispose de contenus photographiques associés.

Remarque : Le nombre de photos renvoyées varie en fonction de la requête.

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

Chaque élément photo contient les champs suivants:

  • photo_reference : chaîne utilisée pour identifier la photo lorsque vous effectuez une requête de photos de lieu (ancienne).
  • height : hauteur maximale de l'image.
  • width : largeur maximale de l'image.
  • html_attributions[] : contient toutes les attributions obligatoires. Ce champ est toujours présent, mais peut être vide.

Les photos renvoyées par Place Photos (ancienne version) sont extraites de plusieurs sources : elles peuvent être fournies par des propriétaires d'établissement ou par des utilisateurs. Dans la plupart des cas, les photos de lieu peuvent être utilisées sans attribution, ou contiendront déjà l'attribution. 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.

L'exemple suivant montre une requête Place Details (ancienne) :

curl "https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJcUElzOzMQQwRLuV30nMUEUM&key=YOUR_API_KEY"

Vous trouverez ci-dessous un exemple de matrice photos[] dans la réponse.

    ...
    "photos" : [
       {
          "html_attributions" : [],
          "height" : 853,
          "width" : 1280,
          "photo_reference" : "ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q"
       }]
    ...

Exemple de Photos du lieu (ancienne version)

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

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q&key=YOUR_API_KEY

Réponse Place Photos (ancienne)

La réponse d'une requête Place Photos (ancienne) réussie est une image. Le type d'image dépend du type de 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 "Quota dépassé"

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