Vous êtes prêt !

Pour passer à l'étape de développement, accédez à notre documentation pour les développeurs.

Activer Google Places API Web Service

Pour commencer, nous allons vous guider à travers la console Google Developers et effectuer deux ou trois petites choses :

  1. Créer ou choisir un projet
  2. Activer Google Places API Web Service
  3. Créer les clés appropriées
Continuer

Place Photos

Le service Place Photo, intégré à Google Places API Web Service, est une API en lecture seule qui permet d'ajouter du contenu photographique de qualité supérieure à votre application. Le service Place Photo vous donne accès à des millions de photos stockées dans les bases de données Places et Google + Local. Lorsque vous obtenez des informations sur un lieu à l'aide d'une requête de détails de lieu, des références photo sont renvoyées pour le contenu photographique correspondant. Les requêtes de recherche de lieux à proximité et de recherche textuelle renvoient également une référence photo unique par lieu, le cas échéant. À l'aide du service Photo, vous pouvez ensuite accéder aux photos référencées et redimensionner l'image pour qu'elle s'adapte parfaitement à votre application.

Références photo

Toutes les requêtes au service Place Photo doivent inclure un paramètre photoreference, renvoyé dans la réponse à requête de recherche de lieux à proximité, de recherche textuelle ou de détails de lieu. La réponse à ces requêtes contient un champ photos[] si le lieu est associé à du contenu photographique.

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

  • Une recherche de lieux à proximité ou une recherche textuelle renvoie au maximum un élément photo dans le tableau.
  • Les recherches de radar ne renvoient aucune photo.
  • Une requête de détails de lieu 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 lancez une requête de photo.
  • height — Hauteur maximale de l'image.
  • width — Largeur maximale de l'image.
  • html_attributions[] — Contient les mentions requises. Ce champ est toujours présent mais peut être vide.

Les photos renvoyées par le service Photo sont extraites de sources variées, notamment les propriétaires d'entreprise et les photos fournies par les utilisateurs de Google+. Dans la plupart des cas, ces photos peuvent être utilisées sans mention ou bien la mention requise est incluse dans l'image. Toutefois, si l'élément photo renvoyé inclut une valeur dans le champ html_attributions, vous devez inclure la mention supplémentaire dans votre application avec l'image affichée.

Voici un exemple de tableau photos[].

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

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 toutes les URL, les différents paramètres sont séparés par une esperluette (&). Vous trouverez ci-dessous la liste des paramètres et leurs différentes valeurs possibles.

Paramètres obligatoires

  • keyClé d'API de votre application. Cette clé identifie votre application à des fins de gestion des quotas. Voir Obtenir une clé pour plus d'informations.
  • photoreference — Identifiant de chaîne qui identifie une photo de manière unique. Les références photo sont renvoyées à partir d'une recherche de lieux ou de détails de lieu.
  • maxheight ou maxwidth — Spécifie la hauteur ou largeur maximum souhaitée, en pixels, de l'image renvoyée par le service Place Photos. Si l'image est plus petite que les valeurs spécifiées, l'image originale est renvoyée. Si l'image est plus grande dans l'une ou l'autre des dimensions, elle est redimensionnée pour correspondre à la plus petite des deux dimensions, en respectant le facteur de forme d'origine. Les propriétés maxheight et maxwidth acceptent un entier compris entre 1 et 1 600.

Voici un exemple de requête. Cette requête renvoie l'image référencée en la redimensionnant pour qu'elle mesure 400 pixels maximum.

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photoreference=CnRtAAAATLZNl354RwP_9UKbQ_5Psy40texXePv4oAlgP4qNEkdIrkyse7rPXYGd9D_Uj1rVsQdWT4oRz4QrYAJNpFX7rzqqMlZw2h2E2y5IKMUZ7ouD_SlcHxYq1yL4KbKUv3qtWgTK0A6QbGh87GB3sscrHRIQiG2RrmU_jF4tENr9wGS_YxoUSSDrYjWmrNfeEHSGSc3FyhNLlBU&key=YOUR_API_KEY

Remarque : Vous devez remplacer la clé d'API de cet exemple pour adapter la requête à votre application.

Réponses aux requêtes Place Photo

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 le quota disponible, le serveur renvoie un statut HTTP 403 et affiche l'image suivante pour indiquer que le quota a été dépassé :

Image Quota dépassé

Si le serveur ne comprend pas votre requête, il renvoie le statut HTTP 400 qui indique une requête non valide. Les raisons les plus courantes expliquant une requête non valide sont les suivantes :

  • La référence photo envoyée n'a pas été définie correctement.
  • Votre requête n'inclut pas le paramètre maxwidth ou maxheight.

Messages d'erreur

Lorsque le service Places renvoie un code de statut HTTP 400, l'objet de la réponse peut comporter un champ error_message supplémentaire. Ce champ contient des informations plus détaillées sur le motif de ce code de statut.

Paramètre sensorsensor

Google Places API Web Service exigeait auparavant l'insertion du paramètre sensor sensor pour savoir si votre application utilisait un capteur afin de déterminer la position géographique de l'utilisateur. Désormais, ce paramètre n'est plus obligatoire.

Envoyer des commentaires concernant…

location_on
Google Places API Web Service