Ce produit est obsolète. Depuis octobre 2026, l'ancienne API Places ne peut plus être activée pour les nouveaux projets Google Cloud. Les projets existants restent entièrement compatibles. Pour bénéficier de nouvelles fonctionnalités et de performances améliorées, migrez vers l'API Places (nouvelle version).

Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Text Search (ancienne version)

Développeurs de l'Espace économique européen (EEE)

Remarque : Bibliothèques côté serveur et côté client

L'API Places est également disponible avec les clients Java, Python, Go et Node.js pour les services Google Maps. L'API Places et les bibliothèques clientes sont destinées à être utilisées dans des applications serveur.

Si vous créez une application côté client, consultez le SDK Places pour Android (New), le SDK Places pour iOS (New) et la bibliothèque Places, API Maps JavaScript.

Text Search (ancienne version) renvoie des informations sur un ensemble de lieux en fonction d'une chaîne, par exemple "pizza à New York", "magasin de chaussures près d'Ottawa" ou "123 Main Street". Ce service renvoie une liste des lieux correspondant à la chaîne de texte et aux limitations de zone géographique définis.

Text Search (ancienne version) n'est pas destiné aux requêtes ambiguës, y compris les suivantes :

Type de requête	Exemple
Trop de concepts ou de contraintes, comme les noms de plusieurs lieux, routes ou villes dans une même requête	"Market Street San Francisco San Jose Airport"
Éléments d'adresse postale non représentés sur Google Maps	"C/O John Smith 123 Main Street" "P.O. Box 13 San Francisco"
Noms d'entreprises, de chaînes ou de catégories associés à des zones géographiques où ces entités ne sont pas disponibles	"Tesco près de Dallas, Texas"
Requêtes ambiguës avec plusieurs interprétations	"Charger drop-off"
Noms historiques qui ne sont plus utilisés	"Middlesex United Kingdom"
Éléments ou intention non géospatiaux	"Combien de bateaux y a-t-il dans le port de Ventura ?"
Noms non officiels ou personnalisés	"The Jenga" "The Helter Skelter"
Coordonnées (latitude et longitude)	"37.422131,-122.084801"

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

Requêtes Text Search (ancienne version)

Une requête Text Search (ancienne version) est une URL HTTP au format suivant :

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

où output peut correspondre à l'une des valeurs suivantes :

json (recommandé) indique une sortie au format JSON (JavaScript Object Notation).
xml indique une sortie au format XML.

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

Paramètres obligatoires

requête

Chaîne de texte sur laquelle doit porter la recherche, par exemple "restaurant" ou "123 Main Street". Il doit s'agir d'un nom de lieu, d'une adresse ou d'une catégorie d'établissements. Tout autre type d'entrée peut générer des erreurs, et ne renverra peut-être pas de résultats valides. Le service Google Places renvoie les résultats correspondant à cette chaîne et les classe en fonction de leur pertinence estimée.
rayon

Définit la distance (en mètres) dans laquelle renvoyer les résultats de lieux. Vous pouvez affiner les résultats à un cercle donné en transmettant les paramètres location et radius. Vous indiquez ainsi au service 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.

Le rayon est automatiquement limité à une valeur maximale en fonction du type de recherche et d'autres paramètres.
- Saisie semi-automatique : 50 000 mètres
- Nearby Search :
  - avec keyword ou name : 50 000 mètres
  - sans keyword ni name
    - Jusqu'à 50 000 mètres, ajusté de manière dynamique en fonction de la densité de la zone, indépendamment du paramètre rankby.
    - Lorsque vous utilisez rankby=distance, le paramètre de rayon n'est pas accepté et génère une erreur INVALID_REQUEST.
- Query Autocomplete : 50 000 mètres
- Text Search : 50 000 mètres

Paramètres facultatifs

language

Langue dans laquelle les résultats doivent être renvoyés.
- Consultez la liste des langues acceptées. Google met souvent à jour les langues acceptées. Cette liste n'est donc pas exhaustive.
- Si language n'est pas fourni, l'API tente d'utiliser la langue préférée spécifiée dans l'en-tête Accept-Language.
- L'API s'efforce de fournir une adresse postale lisible à la fois pour l'utilisateur et pour les habitants. Pour atteindre cet objectif, elle renvoie les adresses postales dans la langue locale, translittérées dans un script lisible par l'utilisateur si nécessaire, en respectant la langue préférée. Toutes les autres adresses sont renvoyées dans la langue préférée. Les composants d'adresse sont tous renvoyés dans la même langue, qui est choisie à partir du premier composant.
- Si aucun nom n'est disponible dans la langue préférée, l'API utilise la correspondance la plus proche.
- La langue préférée a une légère influence sur l'ensemble des résultats que l'API choisit de renvoyer et sur l'ordre dans lequel ils sont renvoyés. Le geocoder interprète les abréviations différemment selon la langue, par exemple les abréviations des types de rues ou les synonymes qui peuvent être valides dans une langue, mais pas dans une autre. Par exemple, utca et tér sont des synonymes de "rue" en hongrois.
position

Point autour duquel récupérer les informations sur le lieu. Cette valeur doit être spécifiée en tant que latitude,longitude.

Le paramètre location peut être ignoré si query contient un emplacement explicite tel que Market in Barcelona. L'utilisation de guillemets autour de la requête peut également influencer l'importance accordée à location et radius.
maxprice

Restreint les résultats aux seuls lieux compris dans la plage spécifiée. 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.
minprice

Restreint les résultats aux seuls lieux compris dans la plage spécifiée. 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

Ne renvoie que les lieux ouverts au moment de l'envoi de la requête. 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 jusqu'à 20 résultats d'une recherche précédemment exécutée. La définition d'un paramètre pagetoken exécute 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.
région

Code régional, spécifié sous la forme d'une valeur ccTLD (domaine de premier niveau) à deux caractères. La plupart des codes ccTLD sont identiques aux codes ISO 3166-1, à quelques exceptions près. Par exemple, le ccTLD du Royaume-Uni est "uk" (.co.uk), tandis que son code ISO 3166-1 est "gb" (techniquement pour l'entité "Royaume-Uni de Grande-Bretagne et d'Irlande du Nord").
type

Limite les résultats aux lieux correspondant au type spécifié. Vous ne pouvez spécifier qu'un seul type. Si plusieurs types sont fournis, tous les types spécifiés après la première entrée sont ignorés.
- type=hospital|pharmacy|doctor devient type=hospital
- type=hospital,pharmacy,doctor est complètement ignoré.
Consultez la liste des types compatibles.

Remarque : L'ajout de keyword et de type avec la même valeur (keyword=cafe&type=cafe ou keyword=parking&type=parking) peut générer ZERO_RESULTS.

Exemples de Text Search (ancienne version)

Remarque : Dans ces exemples, vous devez remplacer key par votre propre clé API pour que la requête fonctionne dans votre application.

Exemple de base

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

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=restaurants%20in%20Sydney&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/textsearch/json
  ?query=restaurants%20in%20Sydney
  &key=YOUR_API_KEY

Exemple d'adresse incomplète

L'exemple suivant montre une recherche d'adresse incomplète, en l'occurrence une adresse postale qui n'inclut pas de ville, d'État ni de pays.

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=123%20main%20street&key=YOUR_API_KEY'

HTTP

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

JSON

{
  "html_attributions": [],
  "results":
    [
      {
        "formatted_address": "Main St, Denver, CO 80238, USA",
        "geometry":
          {
            "location": { "lat": 39.782267, "lng": -104.8919341 },
            "viewport":
              {
                "northeast":
                  { "lat": 39.78361682989273, "lng": -104.8905842701073 },
                "southwest":
                  { "lat": 39.78091717010729, "lng": -104.8932839298927 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png",
        "icon_background_color": "#7B9EB0",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
        "name": "Main St",
        "place_id": "ChIJIS85_gd7bIcRJIGEPue1cJI",
        "reference": "ChIJIS85_gd7bIcRJIGEPue1cJI",
        "types": ["route"],
      },
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>Main St</name>
  <type>route</type>
  <formatted_address>Main St, Denver, CO 80238, USA</formatted_address>
  <geometry>
   <location>
    <lat>39.7822670</lat>
    <lng>-104.8919341</lng>
   </location>
   <viewport>
    <southwest>
     <lat>39.7809172</lat>
     <lng>-104.8932839</lng>
    </southwest>
    <northeast>
     <lat>39.7836168</lat>
     <lng>-104.8905843</lng>
    </northeast>
   </viewport>
  </geometry>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png</icon>
  <reference>ChIJIS85_gd7bIcRJIGEPue1cJI</reference>
  <place_id>ChIJIS85_gd7bIcRJIGEPue1cJI</place_id>
  <icon_background_color>#7B9EB0</icon_background_color>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri>
 </result>
</PlaceSearchResponse>

Exemple de biais de localisation

L'exemple suivant montre une recherche de la même adresse incomplète que dans l'exemple précédent, et inclut les paramètres location et radius pour orienter les résultats vers une région d'intérêt.

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=123%20main%20street&location=42.3675294%2C-71.186966&radius=10000&key=YOUR_API_KEY'

HTTP

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

JSON

{
  "html_attributions": [],
  "results":
    [
      {
        "formatted_address": "123 Main St, Boston, MA 02110, USA",
        "geometry":
          {
            "location": { "lat": 42.3744917, "lng": -71.0634802 },
            "viewport":
              {
                "northeast":
                  { "lat": 42.37581642989272, "lng": -71.06219107010727 },
                "southwest":
                  { "lat": 42.37311677010727, "lng": -71.06489072989272 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png",
        "icon_background_color": "#7B9EB0",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
        "name": "123 Main St",
        "place_id": "ChIJd_ueCe1w44kRD_KFuN5w5nA",
        "plus_code":
          {
            "compound_code": "9WFP+QJ Boston, Massachusetts",
            "global_code": "87JC9WFP+QJ",
          },
        "reference": "ChIJd_ueCe1w44kRD_KFuN5w5nA",
        "types": ["street_address"],
      },
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>123 Main St</name>
  <type>street_address</type>
  <formatted_address>123 Main St, Boston, MA 02110, USA</formatted_address>
  <geometry>
   <location>
    <lat>42.3744917</lat>
    <lng>-71.0634802</lng>
   </location>
   <viewport>
    <southwest>
     <lat>42.3731168</lat>
     <lng>-71.0648907</lng>
    </southwest>
    <northeast>
     <lat>42.3758164</lat>
     <lng>-71.0621911</lng>
    </northeast>
   </viewport>
  </geometry>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png</icon>
  <reference>ChIJd_ueCe1w44kRD_KFuN5w5nA</reference>
  <place_id>ChIJd_ueCe1w44kRD_KFuN5w5nA</place_id>
  <plus_code>
   <global_code>87JC9WFP+QJ</global_code>
   <compound_code>9WFP+QJ Boston, Massachusetts</compound_code>
  </plus_code>
  <icon_background_color>#7B9EB0</icon_background_color>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri>
 </result>
</PlaceSearchResponse>

Réponses Text Search (ancienne version)

Les réponses de recherche sont renvoyées au format indiqué par l'option output dans le chemin d'accès de la requête d'URL.

L'exemple suivant montre une réponse Text Search (ancienne version).

JSON

{
  "html_attributions": [],
  "next_page_token": "Aap_uEAHsgFErpxZrytW1mgKsefD327VCf0OgNF9vpXPwTOG6AGhEZpGgMgofSzgCahevXhneCe9M9H24SOuE4ZcaE0ZR01gVykQZ6EoDnlWEQvXBXe6z0sgF5MQo7qBb6uD4VHKDLhgR59Lb86BzTHJzTzbm61OAPvyInZoaQxK8-oEf2PShZT7XRJKoF5nISbwvU_-RomwGDVi27oj0fToIyV-Vj2ftJw8ZUPbdGGCbcDolQyAwj11Dy2aaeK4SGwg2mO5Akxa7fCze2RJ0GCAvXXp7omTFDy_47OXsFgDPfzluc7mEb5VlzlIMZ0eWQ8VeNigtv-XZZG0f3HSo81Yeq3QhXedJ5oNE1XCwyMly3YVgw_h3amOzAOuDigF1pgFnfGyzxD8vr2bfbPTNvA9l7IJ8Q",
  "results":
    [
      {
        "business_status": "OPERATIONAL",
        "formatted_address": "1 Macquarie St, Sydney NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8592041, "lng": 151.2132635 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85786707010728, "lng": 151.2147093298927 },
                "southwest":
                  { "lat": -33.86056672989272, "lng": 151.2120096701072 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png",
        "icon_background_color": "#FF9E67",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet",
        "name": "Aria Restaurant Sydney",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 4032,
              "html_attributions":
                [
                  'Dohyun Kim',
                ],
              "photo_reference": "Aap_uED7B83PoQ1wNgzYcFZEOw1P2DqNjlaqiXxo-r4F_NaR27uV2OiIvijkI6RYyfiiHYo9UqjnZkRtZaNTk4C6Ickh3k3stsSvBU0KfLtFow-oRujSYYChYwiYhVyP27omLzQQjafhJ2N3LJbjcMxSePKXsQzYCqmOLWg0E9mSExMJ4aM",
              "width": 3024,
            },
          ],
        "place_id": "ChIJdxxU1WeuEmsR11c4fswX-Io",
        "plus_code":
          {
            "compound_code": "46R7+88 Sydney, New South Wales, Australia",
            "global_code": "4RRH46R7+88",
          },
        "price_level": 4,
        "rating": 4.5,
        "reference": "ChIJdxxU1WeuEmsR11c4fswX-Io",
        "types": ["restaurant", "point_of_interest", "food", "establishment"],
        "user_ratings_total": 1681,
      },
      {
        "business_status": "OPERATIONAL",
        "formatted_address": "15 Bligh St, Sydney NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8651396, "lng": 151.2104533 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86384167010728, "lng": 151.2118993298927 },
                "southwest":
                  { "lat": -33.86654132989272, "lng": 151.2091996701073 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png",
        "icon_background_color": "#FF9E67",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet",
        "name": "Restaurant Hubert",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 683,
              "html_attributions":
                [
                  'Ashley Hughes',
                ],
              "photo_reference": "Aap_uEB41WOb_Nl8I8py4D6uXoLHzVYtFZZcucYdYAN1FtzXBnAu59xXrxk5tekoktAbklwmHeSFfdnTCWgHRZ1C5Azp9AMCP9GRGV1f2Z1-5kjsVgnYPiq82JoueSUdCSQJFabyL0cagtcGaFKetVi7DmUIHDQknEPCh_cpCbdOMw4Bkq5q",
              "width": 1024,
            },
          ],
        "place_id": "ChIJF5-RdGquEmsR5rN_H74uSqQ",
        "plus_code":
          {
            "compound_code": "46M6+W5 Sydney, New South Wales, Australia",
            "global_code": "4RRH46M6+W5",
          },
        "price_level": 3,
        "rating": 4.6,
        "reference": "ChIJF5-RdGquEmsR5rN_H74uSqQ",
        "types": ["restaurant", "point_of_interest", "food", "establishment"],
        "user_ratings_total": 2393,
      },
      // ...
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>Aria Restaurant Sydney</name>
  <type>restaurant</type>
  <type>point_of_interest</type>
  <type>food</type>
  <type>establishment</type>
  <formatted_address>1 Macquarie St, Sydney NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8592041</lat>
    <lng>151.2132635</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8605667</lat>
     <lng>151.2120097</lng>
    </southwest>
    <northeast>
     <lat>-33.8578671</lat>
     <lng>151.2147093</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.5</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png</icon>
  <reference>ChIJdxxU1WeuEmsR11c4fswX-Io</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEDOK3C-umU4a2um8NR1G_b_MNPEG1ogm0PLp49myXaj0AD2aT60YrNlbrwnvg2VBrCmE2kBsuDmwZgXL8V-vU2ToVhNgp3A8zAjtx15slWyCxm3WCvWFEPE-_eBoj0Dlh83k_oWPN65B0blYM-qXLBY1PJZbq14gOUXabf31PSo1yA</photo_reference>
   <width>3024</width>
   <height>4032</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/112033760018394328606&quot;&gt;Dohyun Kim&lt;/a&gt;</html_attribution>
  </photo>
  <price_level>4</price_level>
  <user_ratings_total>1681</user_ratings_total>
  <place_id>ChIJdxxU1WeuEmsR11c4fswX-Io</place_id>
  <plus_code>
   <global_code>4RRH46R7+88</global_code>
   <compound_code>46R7+88 Sydney, New South Wales, Australia</compound_code>
  </plus_code>
  <icon_background_color>#FF9E67</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet</icon_mask_base_uri>
 </result>
 <result>
  <name>Restaurant Hubert</name>
  <type>restaurant</type>
  <type>point_of_interest</type>
  <type>food</type>
  <type>establishment</type>
  <formatted_address>15 Bligh St, Sydney NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8651396</lat>
    <lng>151.2104533</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8665413</lat>
     <lng>151.2091997</lng>
    </southwest>
    <northeast>
     <lat>-33.8638417</lat>
     <lng>151.2118993</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.6</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png</icon>
  <reference>ChIJF5-RdGquEmsR5rN_H74uSqQ</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEDhALUBAcrBEprGmkq0_kj9kC4IEWod9h0PZBu-A1mXPN_ZfylpiDXRWxOtuONEFQIqjREf7C28LQDjzqVl4ZD0gZUk4Y0JHPDWaTlfVwijaPfw221p175Sk4po7rB2t7HgjQF2c5O12FYnvNzRiCrkOjr4xroJgzcnp1LV0y8w7gtb</photo_reference>
   <width>1024</width>
   <height>683</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/113719639442868633401&quot;&gt;Ashley Hughes&lt;/a&gt;</html_attribution>
  </photo>
  <price_level>3</price_level>
  <user_ratings_total>2393</user_ratings_total>
  <place_id>ChIJF5-RdGquEmsR5rN_H74uSqQ</place_id>
  <plus_code>
   <global_code>4RRH46M6+W5</global_code>
   <compound_code>46M6+W5 Sydney, New South Wales, Australia</compound_code>
  </plus_code>
  <icon_background_color>#FF9E67</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet</icon_mask_base_uri>
 </result>
 <!-- ... -->
 <next_page_token>Aap_uEC8n0Fzu2WsA7IqaEJty09klsnvXEYZe0aL8dIiZx3fOOfo1xYHZR00qrq-obJbYY9YRkftL-Pv__rQ-efJHSxv19gDtol2ARoY9wpi0ENg-vUAkDVt2W0mOqDy4Kjz9rm5-tzk6fhKR6r4wbLkdgXbKLuNM7KEhsjspU0RC5jQZa4FK_cM9qeUPx5IkPdAa11b9EJwKPEy-ixe77eXeRbEzDYhC5rhylkoOGbF1mHVJVxr--u-Ihe0YaFogaWDx50BcCcMN-eDetaUBJwXDnzHxtirIRF5C_yFavCzWcFn5TOC_z9Ltc-U0L5zbv3lQ7Z6kfVuOeKp4u5_lEHwfz-LuHyETKE6QwQypJUPS3AS8BFs2pYm9r_ruao6YVYsFfDGs1-9QPsVUeSjCN3NuRvbkA</next_page_token>
</PlaceSearchResponse>

PlacesTextSearchResponse

Champ	Obligatoire	Type	Description
`html_attributions`	required	Array<string>	Peut contenir un ensemble d'attributions concernant cette fiche qui doivent être présentées à l'utilisateur (certaines fiches peuvent ne pas avoir d'attribution).
`results`	required	Array<Place>	Contient un tableau de lieux. Les requêtes Place Search renvoient un sous-ensemble des champs renvoyés par les requêtes Place Details. Si le champ souhaité n'est pas renvoyé par Place Search, vous pouvez l'utiliser pour obtenir un `place_id`, puis utiliser l'ID de lieu pour effectuer une requête Place Details. Pour en savoir plus, consultez Place.
`status`	required	PlacesSearchStatus	Contient l'état de la requête et éventuellement des informations de débogage qui vous aident à savoir pourquoi la requête a échoué. Pour en savoir plus, consultez PlacesSearchStatus.
`error_message`	facultatif	chaîne	Lorsque le service renvoie un code d'état autre que `OK<`, il peut y avoir un champ `error_message` supplémentaire dans l'objet de réponse. Ce champ contient des informations plus détaillées sur les raisons du code d'état donné. Ce champ n'est pas toujours renvoyé et son contenu est susceptible d'être modifié.
`info_messages`	facultatif	Array<string>	Lorsque le service renvoie des informations supplémentaires sur la spécification de la requête, un champ `info_messages` supplémentaire peut être présent dans l'objet de réponse. Ce champ n'est renvoyé que pour les requêtes réussies. Il n'est pas toujours renvoyé et son contenu est susceptible d'être modifié.
`next_page_token`	facultatif	chaîne	Contient un jeton permettant de renvoyer jusqu'à 20 résultats supplémentaires. Aucun next_page_token n'est renvoyé s'il n'y a pas d'autres résultats à afficher. Le nombre maximal de résultats pouvant être renvoyés est de 60. Un court délai s'écoule entre l'émission d'un next_page_token et sa validation.

PlacesSearchStatus

Codes d'état renvoyés par le service.

OK, qui indique que la requête API a abouti ;
ZERO_RESULTS indiquant que la recherche a abouti, mais n'a renvoyé aucun résultat. Cela peut se produire si la recherche a reçu un latlng dans un emplacement distant.
INVALID_REQUEST, qui indique que la requête API était incorrecte, généralement en raison d'un paramètre de requête obligatoire manquant (location ou radius) ;
OVER_QUERY_LIMIT indiquant l'un des éléments suivants :
- Vous avez dépassé la limite de RPS.
- La facturation n'a pas été activée sur votre compte.
- Le crédit mensuel de 200 $ ou la limite d'utilisation que vous avez définie vous-même a été dépassé.
- Le mode de facturation fourni n'est plus valide (une carte de crédit est arrivée à expiration, par exemple).
Pour en savoir plus sur la résolution de cette erreur, consultez les questions fréquentes sur Maps.
REQUEST_DENIED, qui indique que votre requête a été rejetée, généralement pour les raisons suivantes :
- La requête ne contient pas de clé API.
- Le paramètre key n'est pas valide.
UNKNOWN_ERROR, qui indique une erreur inconnue.

Lieu

Les réponses Place Search renvoient le sous-ensemble suivant des champs Place. Tous les attributs ne sont pas disponibles pour tous les types de lieux. Pour récupérer les champs que Place Search ne renvoie pas, tels que address_components, formatted_phone_number, reviews ou website, transmettez le place_id renvoyé dans une requête Place Details (Ancienne version). Pour connaître la disponibilité des champs et les niveaux de tarification des points de terminaison, consultez Champs de données de lieu (anciens).

Champ	Type	Description
`business_status`	`string`	Indique l'état opérationnel du lieu (s'il s'agit d'une entreprise) : `OPERATIONAL`, `CLOSED_TEMPORARILY` ou `CLOSED_PERMANENTLY`. Cette option est omise si aucune donnée d'état n'existe.
`formatted_address`	`string`	Adresse lisible par l'humain de ce lieu. Renvoyé par Text Search (ancienne version) et Find Place (ancienne version). N'analysez pas l'adresse formatée de manière programmatique. Demandez plutôt `address_components` dans Place Details (ancienne version).
`geometry`	`Geometry`	Contient l'élément `location` géocodé avec les coordonnées `lat` et `lng`, ainsi que l'élément `viewport` préféré avec les limites `northeast` et `southwest`.
`icon`	`string`	URL d'une icône suggérée que vous pouvez afficher lorsque vous indiquez ce résultat sur une carte.
`icon_background_color`	`string`	Code couleur hexadécimal par défaut pour la catégorie du lieu.
`icon_mask_base_uri`	`string`	URL de base d'une icône recommandée, sans l'extension de type de fichier SVG ou PNG.
`name`	`string`	Nom lisible par l'humain du résultat renvoyé. Pour les résultats `establishment`, cette valeur correspond généralement au nom canonique de l'établissement.
`opening_hours`	`PlaceOpeningHours`	Informations sur les horaires d'ouverture. Les points de terminaison Place Search ne renvoient que le sous-champ booléen `open_now`. Demandez `opening_hours` dans Place Details (ancienne version) pour `periods` et `weekday_text`.
`permanently_closed`	`boolean`	Obsolète : utilisez `business_status` pour vérifier l'état opérationnel d'un établissement.
`photos`	`Array<PlacePhoto>`	Tableau d'objets `PlacePhoto`, chacun contenant un `photo_reference`, un `height`, un `width` et un `html_attributions`. Pour en savoir plus sur l'utilisation, consultez Place Photos (ancien).
`place_id`	`string`	Identifiant textuel qui identifie un lieu de manière unique. Transmettez cet ID dans le paramètre `place_id` d'une requête Place Details (ancienne version). Consultez la présentation des ID de lieu.
`plus_code`	`PlusCode`	Référence de lieu encodée dérivée des coordonnées de latitude et de longitude, contenant un `global_code` et un `compound_code` facultatif.
`price_level`	`integer`	Niveau de prix du lieu sur une échelle de `0` à `4`, du moins cher au plus cher. Consultez `price_level`.
`rating`	`number`	Note du lieu, sur une échelle de `1.0` à `5.0`, basée sur l'ensemble des avis des utilisateurs.
`reference`	`string`	Obsolète : utilisez plutôt `place_id`.
`scope`	`string`	Obsolète : indique le champ d'application de `place_id`, qui est toujours `GOOGLE`. Renvoyé par Nearby Search (ancienne version).
`types`	`Array<string>`	Tableau de types de caractéristiques décrivant le résultat donné. Consultez Types de lieux (anciens).
`user_ratings_total`	`integer`	Nombre total de notes, avec ou sans texte d'avis, pour ce lieu.
`vicinity`	`string`	Adresse simplifiée du lieu, comprenant la rue, le numéro et la ville, mais sans le département/la province, le code postal ou le pays. Renvoyé par Nearby Search (ancienne version).

Accéder à des résultats supplémentaires

Par défaut, chaque réponse renvoie jusqu'à 20 résultats establishment par requête. Toutefois, chaque recherche peut renvoyer jusqu'à 60 résultats, répartis sur trois pages. Si votre recherche renvoie plus de 20 résultats, la réponse de recherche inclura une valeur supplémentaire : next_page_token. Transmettez la valeur de next_page_token au paramètre pagetoken d'une nouvelle requête pour afficher l'ensemble de résultats suivant.

Si next_page_token est nul ou n'est pas renvoyé, il n'y a pas d'autres résultats.
Si vous relancez la requête avec le même next_page_token, vous obtiendrez la page de résultats suivante.
La définition de pagetoken entraîne l'ignorance de tous les autres paramètres.
Vous pouvez demander une nouvelle page jusqu'à deux fois après la requête d'origine.
Chaque requête, y compris une requête utilisant next_page_token, est comptabilisée comme une seule requête dans vos limites d'utilisation et est facturée séparément.
Un délai de quelques secondes s'écoule entre l'émission d'un next_page_token et sa validation. Si vous demandez la page suivante avant qu'elle ne soit disponible, une réponse INVALID_REQUEST est renvoyée. Les requêtes avec next_page_token sont toujours facturées.
Remarque : L'utilisation correcte de next_page_token consiste à demander la page de résultats suivante uniquement lorsque l'utilisateur le demande. Nous vous recommandons d'implémenter une pagination réelle (en affichant 20 résultats à la fois) ou d'ajouter des lieux supplémentaires en bas d'une page de résultats une fois que l'utilisateur a fait défiler la page jusqu'à la fin.

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

{
   "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" : [...]
   "status" : "OK"
}

Pour afficher l'ensemble de résultats suivant, vous pouvez envoyer une nouvelle requête en transmettant le résultat de next_page_token au paramètre pagetoken. 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

Text Search (ancienne version) Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Requêtes Text Search (ancienne version)

Paramètres obligatoires

requête

rayon

Paramètres facultatifs

language

position

maxprice

minprice

opennow

pagetoken

région

type

Exemples de Text Search (ancienne version)

Exemple de base

curl

HTTP

Exemple d'adresse incomplète

curl

HTTP

JSON

XML

Exemple de biais de localisation

curl

HTTP

JSON

XML

Réponses Text Search (ancienne version)

JSON

XML

PlacesTextSearchResponse

html_attributions

results

status

error_message

info_messages

next_page_token

PlacesSearchStatus

Lieu

Accéder à des résultats supplémentaires

Text Search (ancienne version)

`html_attributions`

`results`

`status`

`error_message`

`info_messages`

`next_page_token`