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 Place Details, des références photo sont renvoyées pour le contenu photographique correspondant. Les requêtes Find Place (Legacy), Nearby Search (Legacy) et Text Search (Legacy) 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 (ancienne version)

Une requête Place Photos (ancienne version) 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 de leurs valeurs possibles est énumérée ci-dessous.

Paramètres obligatoires

• photo_reference

  Chaîne d'identification qui identifie une photo de manière unique. Les références photo sont renvoyées à partir d'une requête Place Search ou Place Details.

• maxheight ou maxwidth

  maxheight spécifie la hauteur maximale préféré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 dimension, elle sera mise à l'échelle pour correspondre à la plus petite des deux dimensions, tout en conservant son format d'origine.

  maxwidth spécifie la largeur maximale préféré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 sera mise à l'échelle pour correspondre à la plus petite des deux dimensions, tout en conservant son format d'origine.

  Les propriétés maxheight et maxwidth acceptent un nombre entier compris entre 1 et 1600.

  Vous devez spécifier maxheight, maxwidth ou les deux.

Références photo

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

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 version) 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 Place Photos (ancien).
• height : hauteur maximale de l'image.
• width : largeur maximale de l'image.
• html_attributions[] : contient toutes les attributions requises. Ce champ sera toujours présent, mais il peut être vide.

Les photos renvoyées par Place Photos (ancienne version) proviennent de plusieurs sources : elles peuvent être fournies par des propriétaires d'établissement ou par des utilisateurs. Dans la plupart des cas, ces photos 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 version) :

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

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

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

Exemple de Place Photos (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 largeur.

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