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

Recherche de lieux

Google Places API Web Service vous permet de rechercher des informations de lieu ans toute une série de catégories, telles que des établissements, des points d'intérêt importants, des points géographiques, etc. Vous pouvez rechercher des lieux par proximité ou via une chaîne de texte. Une requête Place Search (recherche de lieux) renvoie une liste de lieux avec des informations récapitulatives sur chaque lieu ; des informations supplémentaires peuvent être obtenues à l'aide d'une requête de détails de lieux Place Details.

Requêtes Nearby Search

Dans les versions précédentes de Places API, la Nearby Search s'appelait Place Search.

Une recherche Nearby Search (lieux à proximité) permet de rechercher des lieux dans une zone définie. Vous pouvez affiner la recherche en indiquant des mots clés ou en spécifiant le type de lieu que vous recherchez.

Une requête de recherche de lieux à proximité est une URL HTTP utilisant le format suivant :

https://maps.googleapis.com/maps/api/place/nearbysearch/output?parameters

output peut prendre l'une des valeurs suivantes :

  • json (recommandé) indique que la réponse doit être au format JSON (JavaScript Object Notation).
  • xml indique que la réponse doit être au format XML.

Certains paramètres sont obligatoires pour lancer une requête de recherche de lieux à proximité. Comme pour toutes les URL, les différents paramètres sont séparés par une esperluette (&).

Paramètres obligatoires

  • keyClé d'API de votre application. Elle identifie votre application à des fins de gestion des quotas. Ainsi, les lieux ajoutés à partir de votre application sont immédiatement disponibles pour votre application. Pour plus d'informations, voir Obtenir une clé.
  • location - Valeurs de latitude/longitude autour desquelles vous souhaitez extraire les informations de lieu. Elles doivent être définies comme suit : latitude,longitude.
  • radius - Définit la distance (en mètres) jusqu'à laquelle renvoyer les résultats de lieu. Le rayon maximum autorisé est 50 000 mètres. Notez que le paramètre radius ne doit pas être inclus si rankby=distance (décrit dans la section Paramètres facultatifs ci-dessous) est spécifié.
  • Si le paramètre rankby=distance (décrit dans la section Paramètres facultatifs ci-dessous) est spécifié, un ou plusieurs des paramètres keyword, name et type sont obligatoires.

Paramètres facultatifs

  • keyword - Terme à comparer à l'ensemble du contenu indexé par Google pour ce lieu, y compris mais sans s'y limiter, le nom, le type et l'adresse, ainsi que les avis des clients et autre contenu tiers.
  • language - Code langue qui indique la langue dans laquelle les résultats doivent être renvoyés, si possible. Les recherches sont également affinées par rapport à la langue sélectionnée ; les résultats dans la langue sélectionnée peuvent obtenir un meilleur classement. Voir la liste des langues prises en charge et leurs codes. Notez que cette liste peut ne pas être exhaustive, car nous mettons régulièrement à jour les langues prises en charge.
  • minprice et maxprice (facultatifs) - Limitent les résultats aux seuls lieux compris dans la fourchette de prix définie. Les valeurs valides sont comprises entre 0 (le moins cher) et 4 (le plus cher), inclus. Le montant exact indiqué par une valeur spécifique varie d'une région à l'autre.
  • name - Terme à comparer à l'ensemble du contenu indexé par Google pour ce lieu. Équivalent de keyword. Le champ name n'est plus limité aux noms de lieu. Les valeurs de ce champ sont associées à celles du champ keyword et transmises dans la même chaîne de recherche. Nous vous recommandons de n'utiliser que le paramètre keyword pour tous les termes de recherche.
  • opennow - Renvoie uniquement les lieux ouverts au moment de la recherche. Si vous incluez ce paramètre dans la requête, les lieux sans horaires d'ouverture dans la base de données Google Places ne sont pas renvoyés.
  • rankby - Spécifie l'ordre d'affichage des résultats. Notez que le paramètre rankby ne doit pas être inclus si radius (décrit dans la section Paramètres obligatoires ci-dessus) est inclus. Les valeurs possibles sont les suivantes :
    • prominence (par défaut). Cette option permet de trier les résultats en fonction de leur importance. Les lieux les plus importants dans la zone spécifiée apparaissent en premier. L'importance peut être déterminée par la position du lieu dans l'index Google, sa popularité globale et d'autres facteurs.
    • distance. Cette option affine les résultats de la recherche en fonction de leur distance (dans l'ordre croissant) par rapport au lieu (location) spécifié. Lorsque la distance est spécifiée, un ou plusieurs des paramètres keyword, name ou type sont requis.
  • type - Limite les résultats aux lieux correspondant au type spécifié. Un seul type peut être spécifié (si plusieurs types sont fournis, tous les types spécifiés après la première entrée sont ignorés). Voir la liste des types pris en charge.
  • types (obsolète) - Limite les résultats aux lieux correspondant à au moins l'un des types spécifiés. Séparez les types avec un trait vertical, comme suit :
    type1|type2|etc.
  • pagetoken - Renvoie les 20 résultats suivants à partir d'une recherche précédente. Spécifier un paramètre pagetoken permet d'exécuter une recherche avec les mêmes paramètres que ceux utilisés précédemment. Tous les paramètres autres que pagetoken sont ignorés.
  • zagatselected (obsolète) - Ajoutez ce paramètre (uniquement le nom du paramètre, sans valeur associée) pour limiter votre recherche aux lieux correspondant à des professionnels sélectionnés par Zagat. Ce paramètre ne doit pas inclure de valeur true ou false. Le paramètre zagatselected est en cours d'expérimentation et n'est disponible que pour les clients de Google Places API disposant d'une licence Premium Plan.

Remarque pour les clients Google Maps APIs Premium Plan : Vous devez inclure une clé d'API dans vos requêtes. Vous ne devez pas inclure de paramètre client ou signature dans vos requêtes.

Exemple de recherche à proximité

L'exemple suivant illustre une requête de recherche d'endroits de type « restaurant » dans un rayon de 500 m autour d'un point à Sydney, Australie, et contenant le mot « cruise » :

https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=-33.8670522,151.1957362&radius=500&type=restaurant&keyword=cruise&key=YOUR_API_KEY

Remarque : Dans cet exemple, vous devez remplacer le paramètre key par votre propre clé d'API pour adapter la requête à votre application.

Requêtes Text Search

Le service de recherche de texte de Google Places API est un service Web qui renvoie des informations sur un ensemble de lieux en fonction d'une chaîne de texte. Par exemple, « pizza dans New York », « magasin de chaussures près d'Ottawa » ou « 123 Main Street ». Ce service répond avec une liste des lieux correspondant à la chaîne de texte et aux limitations de zone géographique définis.

Ce service est particulièrement utile pour effectuer des requêtes d'adresses ambiguës dans un système automatisé, et si des composants de la chaîne ne faisant pas partie de l'adresse peuvent correspondre à des établissements ou à des adresses. Des exemples de requêtes d'adresses ambiguës sont les adresses incomplètes, les adresses au format incorrect ou une requête qui inclut des composants ne faisant pas partie de l'adresse, comme des noms d'entreprise.

La réponse à la recherche inclut une liste de lieux. Vous pouvez ajouter une requête de détails sur le lieu pour obtenir plus d'informations sur les lieux indiqués dans la réponse.

Les services de recherche Google Places partagent les mêmes limites d'utilisation. Toutefois, le service de recherche de texte est soumis à un coefficient de 10. Autrement dit, la requête de recherche de texte que vous envoyez compte comme 10 requêtes pour votre quota. Si vous avez acheté Google Places API dans le cadre de votre contrat Google Maps APIs Premium Plan, ce coefficient peut être différent. Pour plus de détails, voir la documentation Google Maps APIs Premium Plan.

Une requête de recherche de texte est une URL HTTP utilisant le format suivant :

https://maps.googleapis.com/maps/api/place/textsearch/output?parameters

output peut prendre l'une des valeurs suivantes :

  • json (recommandé) indique que la réponse doit être au format JSON (JavaScript Object Notation).
  • xml indique que la réponse doit être au format XML.

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 (&).

Paramètres obligatoires

  • query - Chaîne de texte sur laquelle porte la recherche, par exemple, « restaurant » ou « 123 Main Street ». Le service Google Places renvoie les résultats correspondant à cette chaîne et les classe en fonction de leur pertinence. Ce paramètre devient facultatif si le paramètre type est également utilisé dans la requête de recherche.
  • keyClé d'API de votre application. Elle identifie votre application à des fins de gestion des quotas. Ainsi, les lieux ajoutés à partir de votre application sont immédiatement disponibles pour votre application. Voir Obtenir une clé pour Google Places API Web Service pour découvrir comment créer un projet d'API et obtenir votre clé.

Paramètres facultatifs

  • location - Valeurs de latitude/longitude autour desquelles vous souhaitez extraire les informations de lieu. Elles doivent être définies par latitude,longitude. Si vous spécifiez un paramètre location, vous devez spécifier un paramètre radius.
  • radius - Définit la distance (en mètres) en fonction de laquelle affiner les résultats de lieu. Le rayon maximum autorisé est 50 000 mètres. Les résultats à l'intérieur de cette zone sont mieux classés que les résultats à l'extérieur du rayon de recherche. Toutefois, les résultats pertinents en-dehors du rayon peuvent être inclus.
  • language - Code langue qui indique la langue dans laquelle les résultats doivent être renvoyés, si possible. Les recherches sont également affinées par rapport à la langue sélectionnée ; les résultats dans la langue sélectionnée peuvent obtenir un meilleur classement. Voir la liste des langues prises en charge et leurs codes. Notez que cette liste peut ne pas être exhaustive, car nous mettons régulièrement à jour les langues prises en charge.
  • minprice et maxprice (facultatifs) - Limitent les résultats aux seuls lieux compris dans la fourchette de prix définie. Les valeurs valides sont comprises entre 0 (le moins cher) et 4 (le plus cher), inclus. Le montant exact indiqué par une valeur spécifique varie d'une région à l'autre.
  • opennow - Renvoie uniquement les lieux ouverts au moment de la recherche. Si vous incluez ce paramètre dans la requête, les lieux sans horaires d'ouverture dans la base de données Google Places ne sont pas renvoyés.
  • pagetoken - Renvoie les 20 résultats suivants à partir d'une recherche précédente. Spécifier un paramètre pagetoken permet d'exécuter une recherche avec les mêmes paramètres que ceux utilisés précédemment. Tous les paramètres autres que pagetoken sont ignorés.
  • type - Limite les résultats aux lieux correspondant au type spécifié. Un seul type peut être spécifié (si plusieurs types sont fournis, tous les types spécifiés après la première entrée sont ignorés). Voir la liste des types pris en charge.
  • types (obsolète) - Limite les résultats aux lieux correspondant à au moins l'un des types spécifiés. Séparez les types avec un trait vertical (type1|type2|etc.).
  • zagatselected (obsolète) - Ajoutez ce paramètre (uniquement le nom du paramètre, sans valeur associée) pour limiter votre recherche aux lieux correspondant à des professionnels sélectionnés par Zagat. Ce paramètre ne doit pas inclure de valeur true ou false. Le paramètre zagatselected est en cours d'expérimentation et n'est disponible que pour les clients de Google Places API disposant d'une licence Premium Plan.

Vous pouvez affiner les résultats à un cercle donné en spécifiant les paramètres location et radius. Vous indiquez ainsi au service Google Places de privilégier les résultats situés à l'intérieur de ce cercle. Des résultats en-dehors de la zone définie peuvent toutefois être affichés.

Remarque pour les clients Google Maps APIs Premium Plan : Vous devez inclure une clé d'API dans vos requêtes. Vous ne devez pas inclure de paramètre client ou signature dans vos requêtes.

Exemples de recherche de texte

Remarque : Dans ces exemples, vous devez remplacer le paramètre key par votre propre clé d'API pour adapter la requête à votre application.

Exemple 1 : L'exemple suivant montre une recherche de restaurants près de Sydney.

https://maps.googleapis.com/maps/api/place/textsearch/xml?query=restaurants+in+Sydney&key=YOUR_API_KEY

Exemple 2 : L'exemple suivant montre une recherche d'adresse incomplète, dans le cas présent, une adresse postale sans ville, ni état, ni pays.

https://maps.googleapis.com/maps/api/place/textsearch/json?query=123+main+street&key=YOUR_API_KEY

Exemple 3 : L'exemple suivant montre la même recherche d'adresse incomplète que l'exemple 2, mais avec les paramètres location et radius pour affiner les résultats sur une région en particulier. Comparez les résultats de l'exemple 2 et de l'exemple 3.

https://maps.googleapis.com/maps/api/place/textsearch/json?query=123+main+street&location=42.3675294,-71.186966&radius=10000&key=YOUR_API_KEY

Requêtes Radar Search

Le service de recherche de radar de Google Places API permet de rechercher jusqu'à 200 lieux à la fois mais avec moins de détails qu'une recherche de texte ou de lieux à proximité. Avec la recherche de radar, vous pouvez créer des applications qui aident les utilisateurs à identifier des zones d'intérêt spécifiques dans une région géographique.

La réponse à la recherche inclut jusqu'à 200 lieux accompagnés uniquement des informations suivantes sur chaque lieu :

  • Le champ geometry contenant les coordonnées géographiques.
  • L'identifiant place_id que vous pouvez utiliser dans une requête de détails de lieu pour obtenir des informations supplémentaires sur un lieu. Pour plus d'informations sur les identifiants de lieu, voir la présentation des identifiants de lieu.
  • Le champ reference, obsolète. Voir l'avis lié à l'abandon sur cette page.

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

https://maps.googleapis.com/maps/api/place/radarsearch/output?parameters

output peut prendre l'une des valeurs suivantes :

  • json (recommandé) indique que la réponse doit être au format JSON (JavaScript Object Notation).
  • xml indique que la réponse doit être au format XML.

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 (&).

Paramètres obligatoires

  • keyClé d'API de votre application. Elle identifie votre application à des fins de gestion des quotas. Ainsi, les lieux ajoutés à partir de votre application sont immédiatement disponibles pour votre application. Voir Obtenir une clé pour Google Places API Web Service pour découvrir comment créer un projet d'API et obtenir votre clé.
  • location - Valeurs de latitude/longitude autour desquelles vous souhaitez extraire les informations de lieu. Elles doivent être définies comme suit : latitude,longitude.
  • radius - Définit la distance (en mètres) jusqu'à laquelle renvoyer les résultats de lieu. Le rayon maximum autorisé est de 50 000 mètres.
  • Une recherche Radar doit inclure au moins l'un des paramètres keyword, name ou type.

Paramètres facultatifs

  • keyword - Terme à comparer à l'ensemble du contenu indexé par Google pour ce lieu, y compris mais sans s'y limiter, le nom, le type et l'adresse, ainsi que les avis des clients et autre contenu tiers.
  • language - Code langue qui indique la langue dans laquelle les résultats doivent être renvoyés, si possible. Les recherches sont également affinées par rapport à la langue sélectionnée ; les résultats dans la langue sélectionnée peuvent obtenir un meilleur classement. Voir la liste des langues prises en charge et leurs codes. Notez que cette liste peut ne pas être exhaustive, car nous mettons régulièrement à jour les langues prises en charge.
  • minprice et maxprice (facultatifs) - Limitent les résultats aux seuls lieux compris dans la fourchette de prix définie. Les valeurs valides sont comprises entre 0 (le moins cher) et 4 (le plus cher), inclus. Le montant exact indiqué par une valeur spécifique varie d'une région à l'autre.
  • name - Terme à comparer à l'ensemble du contenu indexé par Google pour ce lieu. Équivalent de keyword. Le champ name n'est plus limité aux noms de lieu. Les valeurs de ce champ sont associées à celles du champ keyword et transmises dans la même chaîne de recherche. Nous vous recommandons de n'utiliser que le paramètre keyword pour tous les termes de recherche.
  • opennow - Renvoie uniquement les lieux ouverts au moment de la recherche. Si vous incluez ce paramètre dans la requête, les lieux sans horaires d'ouverture dans la base de données Google Places ne sont pas renvoyés.
  • type - Limite les résultats aux lieux correspondant au type spécifié. Un seul type peut être spécifié (si plusieurs types sont fournis, tous les types spécifiés après la première entrée sont ignorés). Voir la liste des types pris en charge.
  • types (obsolète) - Limite les résultats aux lieux correspondant à au moins l'un des types spécifiés. Séparez les types avec un trait vertical (type1|type2|etc.).
  • zagatselected (obsolète) - Ajoutez ce paramètre (uniquement le nom du paramètre, sans valeur associée) pour limiter votre recherche aux lieux correspondant à des professionnels sélectionnés par Zagat. Ce paramètre ne doit pas inclure de valeur true ou false. Le paramètre zagatselected est en cours d'expérimentation et n'est disponible que pour les clients de Google Places API disposant d'une licence Premium Plan.

Remarque pour les clients Google Maps APIs Premium Plan : Vous devez inclure une clé d'API dans vos requêtes. Vous ne devez pas inclure de paramètre client ou signature dans vos requêtes.

Exemples de recherche Radar

Remarque : Dans ces exemples, vous devez remplacer le paramètre key par votre propre clé d'API pour adapter la requête à votre application.

Exemple 1 : L'exemple ci-dessous renvoie une liste de musées près de Londres en Angleterre.

https://maps.googleapis.com/maps/api/place/radarsearch/json?location=51.503186,-0.126446&radius=5000&type=museum&key=YOUR_API_KEY

Exemple 2 : Combinez les paramètres keyword et type pour exécuter des requêtes plus précises. L'exemple suivant renvoie les restaurants et cafés de Paris décrits comme végétariens par les utilisateurs.

https://maps.googleapis.com/maps/api/place/radarsearch/json?location=48.859294,2.347589&radius=5000&type=cafe&keyword=vegetarian&key=YOUR_API_KEY

Réponses aux recherches

Les réponses aux recherches sont renvoyées au format défini par l'indicateur output dans le chemin de la requête URL.

L'exemple suivant illustre une réponse à une recherche de lieux à proximité. Une réponse à une recherche de texte est similaire, mis à part qu'elle renvoie une adresse (formatted_address) et non une propriété vicinity. Une recherche de radar inclut un nombre de champs limité, tel que décrit ci-dessus.

JSON
{
   "html_attributions" : [],
   "results" : [
      {
         "geometry" : {
            "location" : {
               "lat" : -33.870775,
               "lng" : 151.199025
            }
         },
         "icon" : "http://maps.gstatic.com/mapfiles/place_api/icons/travel_agent-71.png",
         "id" : "21a0b251c9b8392186142c798263e289fe45b4aa",
         "name" : "Rhythmboat Cruises",
         "opening_hours" : {
            "open_now" : true
         },
         "photos" : [
            {
               "height" : 270,
               "html_attributions" : [],
               "photo_reference" : "CnRnAAAAF-LjFR1ZV93eawe1cU_3QNMCNmaGkowY7CnOf-kcNmPhNnPEG9W979jOuJJ1sGr75rhD5hqKzjD8vbMbSsRnq_Ni3ZIGfY6hKWmsOf3qHKJInkm4h55lzvLAXJVc-Rr4kI9O1tmIblblUpg2oqoq8RIQRMQJhFsTr5s9haxQ07EQHxoUO0ICubVFGYfJiMUPor1GnIWb5i8",
               "width" : 519
            }
         ],
         "place_id" : "ChIJyWEHuEmuEmsRm9hTkapTCrk",
         "scope" : "GOOGLE",
         "alt_ids" : [
            {
               "place_id" : "D9iJyWEHuEmuEmsRm9hTkapTCrk",
               "scope" : "APP"
            }
         ],
         "reference" : "CoQBdQAAAFSiijw5-cAV68xdf2O18pKIZ0seJh03u9h9wk_lEdG-cP1dWvp_QGS4SNCBMk_fB06YRsfMrNkINtPez22p5lRIlj5ty_HmcNwcl6GZXbD2RdXsVfLYlQwnZQcnu7ihkjZp_2gk1-fWXql3GQ8-1BEGwgCxG-eaSnIJIBPuIpihEhAY1WYdxPvOWsPnb2-nGb6QGhTipN0lgaLpQTnkcMeAIEvCsSa0Ww",
         "types" : [ "travel_agency", "restaurant", "food", "establishment" ],
         "vicinity" : "Pyrmont Bay Wharf Darling Dr, Sydney"
      },
      {
         "geometry" : {
            "location" : {
               "lat" : -33.866891,
               "lng" : 151.200814
            }
         },
         "icon" : "http://maps.gstatic.com/mapfiles/place_api/icons/restaurant-71.png",
         "id" : "45a27fd8d56c56dc62afc9b49e1d850440d5c403",
         "name" : "Private Charter Sydney Habour Cruise",
         "photos" : [
            {
               "height" : 426,
               "html_attributions" : [],
               "photo_reference" : "CnRnAAAAL3n0Zu3U6fseyPl8URGKD49aGB2Wka7CKDZfamoGX2ZTLMBYgTUshjr-MXc0_O2BbvlUAZWtQTBHUVZ-5Sxb1-P-VX2Fx0sZF87q-9vUt19VDwQQmAX_mjQe7UWmU5lJGCOXSgxp2fu1b5VR_PF31RIQTKZLfqm8TA1eynnN4M1XShoU8adzJCcOWK0er14h8SqOIDZctvU",
               "width" : 640
            }
         ],
         "place_id" : "ChIJqwS6fjiuEmsRJAMiOY9MSms",
         "scope" : "GOOGLE",
         "reference" : "CpQBhgAAAFN27qR_t5oSDKPUzjQIeQa3lrRpFTm5alW3ZYbMFm8k10ETbISfK9S1nwcJVfrP-bjra7NSPuhaRulxoonSPQklDyB-xGvcJncq6qDXIUQ3hlI-bx4AxYckAOX74LkupHq7bcaREgrSBE-U6GbA1C3U7I-HnweO4IPtztSEcgW09y03v1hgHzL8xSDElmkQtRIQzLbyBfj3e0FhJzABXjM2QBoUE2EnL-DzWrzpgmMEulUBLGrtu2Y",
         "types" : [ "restaurant", "food", "establishment" ],
         "vicinity" : "Australia"
      },
      {
         "geometry" : {
            "location" : {
               "lat" : -33.870943,
               "lng" : 151.190311
            }
         },
         "icon" : "http://maps.gstatic.com/mapfiles/place_api/icons/restaurant-71.png",
         "id" : "30bee58f819b6c47bd24151802f25ecf11df8943",
         "name" : "Bucks Party Cruise",
         "opening_hours" : {
            "open_now" : true
         },
         "photos" : [
            {
               "height" : 600,
               "html_attributions" : [],
               "photo_reference" : "CnRnAAAA48AX5MsHIMiuipON_Lgh97hPiYDFkxx_vnaZQMOcvcQwYN92o33t5RwjRpOue5R47AjfMltntoz71hto40zqo7vFyxhDuuqhAChKGRQ5mdO5jv5CKWlzi182PICiOb37PiBtiFt7lSLe1SedoyrD-xIQD8xqSOaejWejYHCN4Ye2XBoUT3q2IXJQpMkmffJiBNftv8QSwF4",
               "width" : 800
            }
         ],
         "place_id" : "ChIJLfySpTOuEmsRsc_JfJtljdc",
         "scope" : "GOOGLE",
         "reference" : "CoQBdQAAANQSThnTekt-UokiTiX3oUFT6YDfdQJIG0ljlQnkLfWefcKmjxax0xmUpWjmpWdOsScl9zSyBNImmrTO9AE9DnWTdQ2hY7n-OOU4UgCfX7U0TE1Vf7jyODRISbK-u86TBJij0b2i7oUWq2bGr0cQSj8CV97U5q8SJR3AFDYi3ogqEhCMXjNLR1k8fiXTkG2BxGJmGhTqwE8C4grdjvJ0w5UsAVoOH7v8HQ",
         "types" : [ "restaurant", "food", "establishment" ],
         "vicinity" : "37 Bank St, Pyrmont"
      },
      {
         "geometry" : {
            "location" : {
               "lat" : -33.867591,
               "lng" : 151.201196
            }
         },
         "icon" : "http://maps.gstatic.com/mapfiles/place_api/icons/travel_agent-71.png",
         "id" : "a97f9fb468bcd26b68a23072a55af82d4b325e0d",
         "name" : "Australian Cruise Group",
         "opening_hours" : {
            "open_now" : true
         },
         "photos" : [
            {
               "height" : 242,
               "html_attributions" : [],
               "photo_reference" : "CnRnAAAABjeoPQ7NUU3pDitV4Vs0BgP1FLhf_iCgStUZUr4ZuNqQnc5k43jbvjKC2hTGM8SrmdJYyOyxRO3D2yutoJwVC4Vp_dzckkjG35L6LfMm5sjrOr6uyOtr2PNCp1xQylx6vhdcpW8yZjBZCvVsjNajLBIQ-z4ttAMIc8EjEZV7LsoFgRoU6OrqxvKCnkJGb9F16W57iIV4LuM",
               "width" : 200
            }
         ],
         "place_id" : "ChIJrTLr-GyuEmsRBfy61i59si0",
         "scope" : "GOOGLE",
         "reference" : "CoQBeQAAAFvf12y8veSQMdIMmAXQmus1zqkgKQ-O2KEX0Kr47rIRTy6HNsyosVl0CjvEBulIu_cujrSOgICdcxNioFDHtAxXBhqeR-8xXtm52Bp0lVwnO3LzLFY3jeo8WrsyIwNE1kQlGuWA4xklpOknHJuRXSQJVheRlYijOHSgsBQ35mOcEhC5IpbpqCMe82yR136087wZGhSziPEbooYkHLn9e5njOTuBprcfVw",
         "types" : [ "travel_agency", "restaurant", "food", "establishment" ],
         "vicinity" : "32 The Promenade, King Street Wharf 5, Sydney"
      }
   ],
   "status" : "OK"
}

Une réponse JSON contient jusqu'à quatre éléments racine :

  • "status" contient des métadonnées sur la requête. Voir Codes de statut ci-dessous.
  • "results" contient un tableau de lieux avec des informations sur chacun. Pour plus d'informations sur ces résultats, voir Résultats de recherche. Places API renvoie jusqu'à 20 résultats establishment par requête. Par ailleurs, les résultats political peuvent être renvoyés pour identifier la zone de la requête.
  • html_attributions contient plusieurs mentions sur cette liste qui doivent être affichées à l'utilisateur.
  • next_page_token contient un jeton pouvant être utilisé pour renvoyer jusqu'à 20 résultats supplémentaires. Le paramètre next_page_token n'est pas renvoyé s'il n'y a aucun résultat supplémentaire à afficher. Le nombre maximum de résultats pouvant être renvoyés est de 60. Il existe un délai entre la génération d'un jeton next_page_token et son entrée en vigueur.

Voir Traitement JSON avec Javascript pour obtenir de l'aide sur l'analyse des réponses JSON.

XML
<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>Rhythmboat Cruises</name>
  <vicinity>Pyrmont Bay Wharf Darling Dr, Sydney</vicinity>
  <type>travel_agency</type>
  <type>restaurant</type>
  <type>food</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8707750</lat>
    <lng>151.1990250</lng>
   </location>
  </geometry>
  <icon>http://maps.gstatic.com/mapfiles/place_api/icons/travel_agent-71.png</icon>
  <place_id>ChIJyWEHuEmuEmsRm9hTkapTCrk</place_id>
  <scope>GOOGLE</scope>
  <alt_ids>
   <place_id>D9iJyWEHuEmuEmsRm9hTkapTCrk</place_id>
   <scope>APP</scope>
  </alt_ids>
  <reference>CoQBdAAAAChhtoQX_467esHavS0Sj9DrY306W3_uDXKmB2us8Eh7_dX7rDuln18i_uqocF_LmzRptuFr6WZs7aeBSLFq8VFmckxFjsXDaqMdd3gvxi_5dIwPTEugQQYG9oJA-YnYfPBvjGtuoMfNnjyU2GuxGRmJjCO77pEAbsTLq44eBG5jEhAvkKHCGqIzqgC9tdOb1dSqGhRA1hhG4pvILD5OEAq6W8L8sXbkug</reference>
  <id>21a0b251c9b8392186142c798263e289fe45b4aa</id>
  <opening_hours>
   <open_now>true</open_now>
  </opening_hours>
  <photo>
   <photo_reference>CnRnAAAAiRA8ls6lx5LTfLuHJtLYvz73LXIMa5EVsHz2OUjh70LBPBnIEULZ57w076gOuyCeJqP041_v-ek3I5C4IkqW7YgA0EBybwywfIcUXsj5W_qiJR2yaXHXI-FmDM6j1zaS0sJQnNJhe4Bl9W42Jx16phIQRmNOWKGIemKLgzNEPcCnmBoUGgr0gWQBwWd8HAseR-5ie3JYuIM</photo_reference>
   <width>519</width>
   <height>270</height>
  </photo>
 </result>
 <result>
  <name>Private Charter Sydney Habour Cruise</name>
  <vicinity>Australia</vicinity>
  <type>restaurant</type>
  <type>food</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8668910</lat>
    <lng>151.2008140</lng>
   </location>
  </geometry>
  <icon>http://maps.gstatic.com/mapfiles/place_api/icons/restaurant-71.png</icon>
  <place_id>ChIJqwS6fjiuEmsRJAMiOY9MSms</place_id>
  <scope>GOOGLE</scope>
  <reference>CpQBhQAAAKGKrbbnAW3_eAypKW9bhAzAuSmaqAogs7MTFxsntDqCzt-gKD9nz-zqNsk0uJsl0yCUYpNYjHz_yzmh3J_4TTxpxIqdaq2uDvfoTYtvm8FkxMAkK3cS7k9t3Ze2aHRWnxlN9hczK2xlc5taDE7xAGOHF5Xe5IlVV1wV66sOrWrlHtGh47lqT9Id86eG2OmlVhIQo4djLtRkceg-zaYjULYEjRoUToVEyOUVCFfZMUs_E7ZLSzjFmcg</reference>
  <id>45a27fd8d56c56dc62afc9b49e1d850440d5c403</id>
  <photo>
   <photo_reference>CnRnAAAAUW97jpK2_C2Lh4jLPVKZlhyS84mqZxvVmWFdc6jdl3XxjzKbYdbJpz0PGW5eFRw6kTKYNZM9QvRf-csFegHILZxLCLJ-6ZnbdEXbVM4kBzOb-rhchJx1KC6LHs_vVWP8bK96569lFYRf7Hn8ylQrlhIQb69_dcZVwqQhREsHW6azWhoU0XMWqZMBBzx-hgpduAaeErOFg8E</photo_reference>
   <width>640</width>
   <height>426</height>
  </photo>
 </result>
 <result>
  <name>Bucks Party Cruise</name>
  <vicinity>37 Bank St, Pyrmont</vicinity>
  <type>restaurant</type>
  <type>food</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8709430</lat>
    <lng>151.1903110</lng>
   </location>
  </geometry>
  <icon>http://maps.gstatic.com/mapfiles/place_api/icons/restaurant-71.png</icon>
  <place_id>ChIJLfySpTOuEmsRsc_JfJtljdc</place_id>
  <scope>GOOGLE</scope>
  <reference>CoQBdAAAAOMUoYamsekTDxBDVyKZ-E54VQ6HjirVzAZBBwz5gcn5KTfmemmwmOAtLcvRScp1NLQmj-fBYzEO2Gq_cO4Dc12PG0_twzDv9zq3KIyNQVuO-r0n1eQVj8Dlng-n4c1F2hMxufCNVp4-QfjMj81qXJm0invQMUc1xNgZRyiOpLe9EhDLn0KiVWEFKOURYsWrHRouGhR7YMJxYmFs-OXjKyzQKGdQXLrzPw</reference>
  <id>30bee58f819b6c47bd24151802f25ecf11df8943</id>
  <opening_hours>
   <open_now>true</open_now>
  </opening_hours>
  <photo>
   <photo_reference>CnRnAAAAjboYP9Ujxe5SmZFN5AJc42AWtpYFX9wYdqjcTXavXJlfoXdHPC2hErdbHcaeYJBNPV6CzoDc2RLw_w9HofGOhCWHtoAl9b3g8TZZjnZobnAHxoljUdgV8PXyd-pCO-QHKOtiKfIdUmF4HRj2QHj6OhIQhLNpoKNKP8MNjk90M4KGrhoUW2NyBgsWjRpUEoWlt0fD48BhEcQ</photo_reference>
   <width>800</width>
   <height>600</height>
  </photo>
 </result>
 <result>
  <name>Australian Cruise Group</name>
  <vicinity>32 The Promenade, King Street Wharf 5, Sydney</vicinity>
  <type>travel_agency</type>
  <type>restaurant</type>
  <type>food</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8675910</lat>
    <lng>151.2011960</lng>
   </location>
  </geometry>
  <icon>http://maps.gstatic.com/mapfiles/place_api/icons/travel_agent-71.png</icon>
  <place_id>ChIJrTLr-GyuEmsRBfy61i59si0</place_id>
  <scope>GOOGLE</scope>
  <reference>CoQBeAAAAJZA0WY2pKnZ6nNnxNd_pSDA2NilDLfGDf7pTt7VssxB5tMYE7400w3HZHRav2unpKRhEp7lrh0yKcVdSfKYIz85k1SExoLGmYD8NIf1dPr8KlkRWOYZUTLGp623r5hAzEGk94mPleF4s50pWqLrhAzwvJb1tGj2ak-2PXQORkeTEhAfTj6tMFo_tRWZYOnYCxiVGhQA3n-KV7AW5MvJlGaIDHuLyyEBBA</reference>
  <id>a97f9fb468bcd26b68a23072a55af82d4b325e0d</id>
  <opening_hours>
   <open_now>true</open_now>
  </opening_hours>
  <photo>
   <photo_reference>CnRnAAAAhTkpwozMoZx_NXMkIrKdcEGe46BmPy3GPCfS-gkCK5PlR8rFDY9DtD_7wFYAIdhVoZz3I9QguRNbil5y37jTU-03GJ_LqVw_avSxFkT0g2kU0K5z2VYnAsgNsrbsK_EVglhg5PrDybC1tAVKCXSGsRIQOcdlAVnC1Qc46YLWjlqdyxoUL5JGZgczfo1jxLxhDeGs8OvBQCk</photo_reference>
   <width>200</width>
   <height>242</height>
  </photo>
 </result>
</PlaceSearchResponse>

Une réponse XML est constituée d'un élément <PlaceSearchResponse> unique et de jusqu'à quatre éléments de niveau supérieur :

  • <status> contient des métadonnées sur la requête. Voir Codes de statut ci-dessous.
  • Zéro, un ou plusieurs éléments <result> contenant chacun des informations sur un établissement unique. Pour plus d'informations sur ces résultats, voir Résultats de la recherche de lieux à proximité. Places API renvoie jusqu'à 20 résultats establishment par requête. Par ailleurs, les résultats political <type> peuvent être renvoyés pour identifier la zone de la requête.
  • next_page_token contient un jeton pouvant être utilisé pour renvoyer jusqu'à 20 résultats supplémentaires. Le paramètre next_page_token n'est pas renvoyé s'il n'y a aucun résultat supplémentaire à afficher. Le nombre maximum de résultats pouvant être renvoyé est de 60. Le jeton next_page_token devient actif 2 secondes après sa génération.
  • html_attributions contient plusieurs mentions sur cette liste qui doivent être affichées à l'utilisateur.

Codes de statut

Le champ "status" de l'objet de la réponse à la recherche contient le statut de la requête et éventuellement des informations de débogage qui vous aident à savoir pourquoi la requête a échoué. Le champ "status" peut contenir les valeurs suivantes :

  • OK indique qu'aucune erreur n'est survenue, que le lieu a été identifié et qu'au moins un résultat a été trouvé.
  • ZERO_RESULTS indique que la recherche a réussi mais n'a renvoyé aucun résultat. Cela peut se produire si la recherche a reçu un paramètre latlng dans un lieu distant.
  • OVER_QUERY_LIMIT indique que vous avez dépassé votre quota.
  • REQUEST_DENIED indique que votre requête a été rejetée, généralement du fait de l'absence d'un paramètre key valide.
  • INVALID_REQUEST indique généralement qu'un paramètre de requête obligatoire (location ou radius) est manquant.

Messages d'erreur

Lorsque le service Google Places renvoie un code de statut autre que OK, l'objet de la réponse à la recherche peut comporter un champ supplémentaire error_message. Ce champ contient des informations plus détaillées sur les causes de ce code de statut.

Résultats des recherches

Le service Google Places renvoie les résultats JSON sous forme de tableau d'éléments results. Même si le service ne renvoie aucun résultat (par exemple, si le paramètre location est un lieu distant), il renvoie malgré tout un tableau results vide. Les réponses XML sont composées de zéro, un ou plusieurs éléments <result>.

Chaque élément du tableau results contient un seul résultat dans la zone spécifiée (location et radius), défini par importance.

Ce résultat peut également contenir des mentions qui doivent être affichées à l'utilisateur. Un exemple de mention au format JSON est présenté ci-dessous :

"html_attributions" : [
      "Listings by \u003ca href=\"http://www.example.com/\"\u003eExample Company\u003c/a\u003e"
],
Voici un exemple de mention au format XML :
<html_attribution>Listings by <a href="http://www.example.com/">Example Company</a></html_attribution>

Chaque résultat du tableau results peut contenir les champs suivants :

  • icon contient l'URL d'une icône recommandée pouvant être affichée à l'utilisateur avec l'indication de ce résultat.
  • id contient un identifiant fixe unique correspondant à ce lieu. Cet identifiant ne peut pas être utilisé pour extraire des informations sur ce lieu, mais reste valide d'une session à l'autre. Il peut être utilisé pour regrouper des données sur ce lieu et pour vérifier l'identité d'un lieu dans plusieurs recherches séparées. Remarque : La propriété id est progressivement abandonnée au profit de place_id. Voir l'avis lié à l'abandon sur cette page.
  • geometry contient les informations géométriques sur le résultat, généralement le géocode (location) du lieu et (en option) la fenêtre d'affichage (viewport) qui identifie sa zone de couverture générale.
  • name contient le nom lisible du résultat renvoyé. Pour les résultats establishment, il s'agit généralement du nom du professionnel.
  • opening_hours peut contenir les informations suivantes :
    • open_now est une valeur booléenne qui indique si le lieu est ouvert actuellement.
  • photos[] — Ensemble d'objets photo contenant chacun une référence à une image. Une requête Place Search renvoie un seul objet photo. Une requête Place Details peut renvoyer jusqu'à 10 photos. Pour plus d'informations sur Place Photos et comment utiliser les images dans votre application, voir la documentation sur les Place Photos. Un objet photo est décrit comme suit :
    • 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.
  • place_id - Identifiant textuel qui identifie un lieu de manière unique. Pour extraire des informations sur le lieu, insérez cet identifiant dans le champ placeid d'une requête Places API. Pour plus d'informations sur les identifiants de lieu, voir la présentation des identifiants de lieu.
  • scope - Spécifie la validité de l'identifiant de lieu (place_id). Les valeurs possibles sont les suivantes :
    • APP : L'identifiant de lieu est reconnu par votre application uniquement. En effet, votre application a ajouté le lieu et ce dernier n'a pas encore été traité par le processus de modération.
    • GOOGLE : Le lieu est disponible pour les autres applications et sur Google Maps.
    Remarque : Le champ scope est inclus uniquement dans les résultats des recherches de lieux à proximité et de détails de lieu. Vous pouvez extraire uniquement les lieux valides pour l'application à l'aide des recherches de lieux à proximité et de détails de lieu. Si le champ scope est absent d'une réponse, on considère que sa validité est GOOGLE.
  • alt_ids — Ensemble d'un ou plusieurs autres identifiants de lieu, ou aucun, avec une validité correspondante pour chacun. Remarque : Cet ensemble peut être vide ou absent. S'il est présent, il contient les champs suivants :
    • place_id — La raison la plus probable pour laquelle un lieu possède un autre identifiant de lieu est le fait que votre application a ajouté un lieu et reçu un identifiant de lieu spécifique avant de recevoir ensuite un identifiant de lieu pour Google une fois le processus de modération passé.
    • scope — La validité d'un autre identifiant de lieu sera toujours APP pour indiquer que cet identifiant de lieu est reconnu par votre application uniquement.
    Par exemple, supposons que votre application ajoute un lieu et reçoit un paramètre place_id AAA pour ce nouveau lieu. Plus tard, le lieu est traité par le processus de modération et reçoit un identifiant Google place_id BBB. À partir de ce moment, les informations sur ce lieu contiennent les paramètres suivants :
        "results" : [
          {
            "place_id" : "BBB",
            "scope" : "GOOGLE",
            "alt_ids" : [
              {
                "place_id" : "AAA",
                "scope" : "APP",
              }
            ],
          }
        ]
        
  • price_level — Niveau de prix du lieu, sur une échelle de 0 à 4. Le montant exact indiqué par une valeur spécifique varie d'une région à l'autre. Les définitions des niveaux de prix sont les suivantes :
    • 0 — Gratuit
    • 1 — Bon marché
    • 2 — Modéré
    • 3 — Cher
    • 4 — Très cher
  • rating contient la note du lieu, sur une échelle de 1.0 à 5.0, basée sur l'ensemble des avis des utilisateurs.
  • reference contient un jeton unique que vous pouvez utiliser pour extraire des informations supplémentaires sur ce lieu dans une requête Place Details. Même si ce jeton identifie le lieu de manière unique, l'inverse n'est pas vrai. Un lieu peut être associé à plusieurs jetons de référence valides. Plusieurs recherches peuvent renvoyer plusieurs jetons différents pour un lieu donné. Remarque : La propriété reference est progressivement abandonnée au profit de place_id. Voir l'avis lié à l'abandon sur cette page.
  • types[] contient un ensemble de types de caractéristiques qui décrivent le résultat donné. Pour plus d'informations, voir la liste des types pris en charge. Les réponses XML incluent plusieurs éléments <type> si plusieurs types sont affectés au résultat.
  • vicinity contient un nom spécifique pour un lieu à proximité. Bien souvent, ce nom fait référence à une rue ou un quartier dans les résultats donnés. La propriété vicinity est renvoyée uniquement pour une requête Nearby Search.
  • formatted_address est une chaîne contenant une adresse lisible de ce lieu. Bien souvent, cette adresse équivaut à l'« adresse postale ». La propriété formatted_address est renvoyée uniquement pour une requête Text Search.
  • permanently_closed est un indicateur booléen qui précise si le lieu a fermé définitivement (valeur true). Si le lieu n'a pas fermé définitivement, cet indicateur ne figure pas dans la réponse.

Données Premium

Outre les champs répertoriés ci-dessus, les clients Google Places API disposant d'une licence Premium Plan peuvent consulter les champs suivants. Ces champs s'affichent comme enfants de niveau supérieur du champ result.

  • aspects contient un objet AspectRating unique pour la note principale de cet établissement. Chaque objet AspectRating se compose comme suit :
    • type, le nom de l'aspect évalué. Les types suivants sont pris en charge : appeal (attrait), atmosphere (ambiance), decor (décor), facilities (commodités), food (nourriture), overall (général), quality (qualité) et service.
    • rating, la note globale pour cet aspect spécifique, sur une échelle de 0 à 30. Notez que les notes globales sont comprises entre 0 et 30, tandis que les notes qui s'affichent dans le cadre d'une évaluation vont de 0 à 3.
  • zagat_selected indique que le lieu est référencé dans le guide Zagat. Le label Zagat identifie les lieux connus pour leur qualité supérieure permanente ou leur caractère spécial ou unique.
Pour plus d'informations, voir Données Premium.

Accéder à des résultats supplémentaires

Par défaut, chaque recherche de lieux à proximité ou de texte renvoie jusqu'à 20 résultats establishment par requête. Toutefois, chaque recherche peut renvoyer jusqu'à 60 résultats, répartis sur trois pages. Si la recherche en renvoie plus de 20, la réponse inclut une valeur supplémentaire : next_page_token. Indiquez la valeur next_page_token dans le paramètre pagetoken d'une nouvelle recherche pour afficher les résultats suivants. Une valeur next_page_token nulle ou absente signifie qu'il n'y a aucun autre résultat. Il existe un délai entre la génération d'un jeton next_page_token et son entrée en vigueur. Demander la page suivante avant qu'elle ne soit disponible renvoie une réponse INVALID_REQUEST. Relancer la requête avec le même paramètre next_page_token renvoie la page de résultats suivante.

Par exemple, dans la requête ci-dessous, nous recherchons des restaurants près de Darling Harbour, à Sydney en Australie, et classons les résultats par distance. Vous pouvez constater que la réponse contient une propriété next_page_token.

https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=-33.8670522,151.1957362&rankby=distance&types=food&key=YOUR_API_KEY
{
   "html_attributions" : [],
   "next_page_token" : "CpQCAgEAAFxg8o-eU7_uKn7Yqjana-HQIx1hr5BrT4zBaEko29ANsXtp9mrqN0yrKWhf-y2PUpHRLQb1GT-mtxNcXou8TwkXhi1Jbk-ReY7oulyuvKSQrw1lgJElggGlo0d6indiH1U-tDwquw4tU_UXoQ_sj8OBo8XBUuWjuuFShqmLMP-0W59Vr6CaXdLrF8M3wFR4dUUhSf5UC4QCLaOMVP92lyh0OdtF_m_9Dt7lz-Wniod9zDrHeDsz_by570K3jL1VuDKTl_U1cJ0mzz_zDHGfOUf7VU1kVIs1WnM9SGvnm8YZURLTtMLMWx8-doGUE56Af_VfKjGDYW361OOIj9GmkyCFtaoCmTMIr5kgyeUSnB-IEhDlzujVrV6O9Mt7N4DagR6RGhT3g1viYLS4kO5YindU6dm3GIof1Q",
   "results" : [
      {
         "geometry" : {
            "location" : {
               "lat" : -33.867217,
               "lng" : 151.195939
            }
         },
         "icon" : "http://maps.gstatic.com/mapfiles/place_api/icons/cafe-71.png",
         "id" : "7eaf747a3f6dc078868cd65efc8d3bc62fff77d7",
         "name" : "Biaggio Cafe - Pyrmont",
         "opening_hours" : {
            "open_now" : true
         },
         "photos" : [
            {
               "height" : 600,
               "html_attributions" : [],
               "photo_reference" : "CnRnAAAAmWmj0BqA0Jorm1_vjAvx1n6c7ZNBxyY-U9x99-oNyOxvMjDlo2npJzyIq7c3EK1YyoNXdMFDcRPzwLJtBzXAwCUFDGo_RtLRGBPJTA2CoerPdC5yvT2SjfDwH4bFf5MrznB0_YWa4Y2Qo7ABtAxgeBIQv46sGBwVNJQDI36Wd3PFYBoUTlVXa0wn-zRITjGp0zLEBh8oIBE",
               "width" : 900
            }
         ],
         "place_id" : "ChIJIfBAsjeuEmsRdgu9Pl1Ps48",
         "scope" : "GOOGLE",
         "price_level" : 1,
         "rating" : 3.4,
         "reference" : "CoQBeAAAAGu0wNJjuZ40DMrRe3mpn7fhlfIK1mf_ce5hgkhfM79u-lqy0G2mnmcueTq2JGWu9wsgS1ctZDHTY_pcqFFJyQNV2P-kdhoRIeYRHeDfbWtIwr3RgFf2zzFBXHgNjSq-PSzX_OU6OT2_3dzdhhpV-bPezomtrarW4DsGl9uh773yEhDJT6R3V8Fyvl_xeE761DTCGhT1jJ3floFI5_c-bHgGLVwH1g-cbQ",
         "types" : [ "cafe", "bar", "restaurant", "food", "establishment" ],
         "vicinity" : "48 Pirrama Rd, Pyrmont"
      },
      {
         "geometry" : {
            "location" : {
               "lat" : -33.866786,
               "lng" : 151.195633
            }
         },
         "icon" : "http://maps.gstatic.com/mapfiles/place_api/icons/generic_business-71.png",
         "id" : "3ef986cd56bb3408bc1cf394f3dad9657c1d30f6",
         "name" : "Doltone House",
         "photos" : [
            {
               "height" : 1260,
               "html_attributions" : [ "From a Google User" ],
               "photo_reference" : "CnRwAAAAeM-aLqAm573T44qnNe8bGMkr_BOh1MOVQaA9CCggqtTwuGD1rjsviMyueX_G4-mabgH41Vpr8L27sh-VfZZ8TNCI4FyBiGk0P4fPxjb5Z1LrBZScYzM1glRxR-YjeHd2PWVEqB9cKZB349QqQveJLRIQYKq2PNlOM0toJocR5b_oYRoUYIipdBjMfdUyJN4MZUmhCsTMQwg",
               "width" : 1890
            }
         ],
         "place_id" : "ChIJ5xQ7szeuEmsRs6Kj7YFZE9k",
         "scope" : "GOOGLE",
         "reference" : "CnRvAAAA22k1PAGyDxAgHZk6ErHh_h_mLUK_8XNFLvixPJHXRbCzg-gw1ZxdqUwA_8EseDuEZKolBs82orIQH4m6-afDZV9VcpggokHD9x7HdMi9TnJDmGb9Bdh8f-Od4DK0fASNBL7Me3CsAWkUMWhlNQNYExIQ05W7VbxDTQe2Kh9TiL840hoUZfiO0q2HgDHSUyRdvTQx5Rs2SBU",
         "types" : [ "food", "establishment" ],
         "vicinity" : "48 Pirrama Rd, Pyrmont"
      },
      {
         "aspects" : [
            {
               "rating" : 23,
               "type" : "overall"
            }
         ],
      ...
   ],
   "status" : "OK"
}

Pour afficher les résultats suivants, vous pouvez soumettre une nouvelle requête en indiquant le résultat de la valeur next_page_token pour le paramètre pagetoken. Par exemple :

https://maps.googleapis.com/maps/api/place/nearbysearch/json?pagetoken=CpQCAgEAAFxg8o-eU7_uKn7Yqjana-HQIx1hr5BrT4zBaEko29ANsXtp9mrqN0yrKWhf-y2PUpHRLQb1GT-mtxNcXou8TwkXhi1Jbk-ReY7oulyuvKSQrw1lgJElggGlo0d6indiH1U-tDwquw4tU_UXoQ_sj8OBo8XBUuWjuuFShqmLMP-0W59Vr6CaXdLrF8M3wFR4dUUhSf5UC4QCLaOMVP92lyh0OdtF_m_9Dt7lz-Wniod9zDrHeDsz_by570K3jL1VuDKTl_U1cJ0mzz_zDHGfOUf7VU1kVIs1WnM9SGvnm8YZURLTtMLMWx8-doGUE56Af_VfKjGDYW361OOIj9GmkyCFtaoCmTMIr5kgyeUSnB-IEhDlzujVrV6O9Mt7N4DagR6RGhT3g1viYLS4kO5YindU6dm3GIof1Q&key=YOUR_API_KEY

Indiquer le paramètre pagetoken entraîne la non prise en compte des autres paramètres. La requête exécute la même recherche qu'auparavant mais renvoie un tout nouvel ensemble de résultats. Vous pouvez demander une nouvelle page jusqu'à deux fois après la requête initiale. Chaque page de résultats s'affiche alors. Une même requête ne doit pas renvoyer plus d'une page de résultats. Notez que chaque résultat correspond à une requête unique dans vos limites d'utilisation.

Paramètre sensor

Google Places API exigeait auparavant l'insertion du paramètre 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