Ricerca di testo (legacy)

Sviluppatori dello Spazio economico europeo (SEE)

Una Ricerca testuale (legacy) restituisce informazioni su un insieme di luoghi in base a una stringa, ad esempio "pizza a New York", "negozi di scarpe vicino a Ottawa" o "123 Main Street". Il servizio risponde con un elenco di luoghi corrispondenti alla stringa di testo e a qualsiasi bias di località impostato.

Ricerca testuale (Legacy) non è destinata a query ambigue, tra cui:

Tipo di query Esempio
Troppi concetti o vincoli, ad esempio i nomi di più luoghi, strade o città in una singola query "Market Street San Francisco San Jose Airport"
Elementi dell'indirizzo postale non rappresentati su Google Maps "C/O Mario Rossi, Via Roma 123"
"Casella postale 13, San Francisco"
Nomi di attività, catene o categorie combinati con località in cui queste entità non sono disponibili "Tesco vicino a Dallas, Texas"
Query ambigue con più interpretazioni "Consegna del caricabatterie"
Nomi storici non più in uso "Middlesex United Kingdom"
Elementi o intenti non geospaziali "Quante barche ci sono nel porto di Ventura?"
Nomi non ufficiali o vanity "The Jenga"
"The Helter Skelter"
Coordinate di latitudine e longitudine "37.422131,-122.084801"

La risposta alla ricerca include un elenco di luoghi. Puoi inviare una richiesta Place Details per ottenere ulteriori informazioni su uno dei luoghi nella risposta.

Richieste di Ricerca testuale (Legacy)

Una richiesta di Ricerca testuale (legacy) è un URL HTTP nel seguente formato:

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

dove output può essere uno dei seguenti valori:

  • json (consigliato) indica l'output in JavaScript Object Notation (JSON)
  • xml indica l'output in formato XML

Per avviare una richiesta di ricerca sono necessari alcuni parametri. Come è standard negli URL, tutti i parametri sono separati utilizzando il carattere e commerciale (&).

Parametri obbligatori

  • query

    La stringa di testo su cui eseguire la ricerca, ad esempio "ristorante" o "123 Main Street". Deve essere un nome di luogo, un indirizzo o una categoria di attività. Qualsiasi altro tipo di input può generare errori e non è garantito che restituisca risultati validi. Il servizio Google Places restituisce corrispondenze candidate in base a questa stringa e ordina i risultati in base alla loro pertinenza percepita.

  • raggio

    Definisce la distanza (in metri) entro la quale restituire i risultati dei luoghi. Puoi influenzare i risultati in base a un cerchio specificato passando un parametro location e un parametro radius. In questo modo, il servizio Places viene istruito a preferire la visualizzazione dei risultati all'interno di quel cerchio; i risultati al di fuori dell'area definita potrebbero comunque essere visualizzati.

    Il raggio verrà automaticamente limitato a un valore massimo a seconda del tipo di ricerca e di altri parametri.

    • Completamento automatico: 50.000 metri
    • Nearby Search:
      • con keyword o name: 50.000 metri
      • senza keyword o name
        • Fino a 50.000 metri, regolati dinamicamente in base alla densità dell'area, indipendentemente dal parametro rankby.
        • Quando utilizzi rankby=distance, il parametro radius non verrà accettato e verrà generato un errore INVALID_REQUEST.
    • Query Autocomplete: 50.000 metri
    • Ricerca testuale: 50.000 metri

Parametri facoltativi

  • language

    La lingua in cui restituire i risultati.

    • Consulta l'elenco delle lingue supportate. Google aggiorna spesso le lingue supportate, pertanto questo elenco potrebbe non essere esaustivo.
    • Se language non viene fornito, l'API tenta di utilizzare la lingua preferita specificata nell'intestazione Accept-Language.
    • L'API fa del suo meglio per fornire un indirizzo leggibile sia per l'utente sia per le persone del posto. Per raggiungere questo obiettivo, restituisce gli indirizzi nella lingua locale, traslitterati in un alfabeto leggibile dall'utente, se necessario, rispettando la lingua preferita. Tutti gli altri indirizzi vengono restituiti nella lingua preferita. I componenti dell'indirizzo vengono restituiti tutti nella stessa lingua, che viene scelta dal primo componente.
    • Se un nome non è disponibile nella lingua preferita, l'API utilizza la corrispondenza più vicina.
    • La lingua preferita ha una piccola influenza sull'insieme di risultati che l'API sceglie di restituire e sull'ordine in cui vengono restituiti. Il geocodificatore interpreta le abbreviazioni in modo diverso a seconda della lingua, ad esempio le abbreviazioni per i tipi di strade o i sinonimi che potrebbero essere validi in una lingua ma non in un'altra. Ad esempio, utca e tér sono sinonimi di strada in ungherese.

  • località

    Il punto intorno al quale recuperare le informazioni sul luogo. Deve essere specificato come latitude,longitude.

    Il parametro location potrebbe essere sostituito se query contiene una località esplicita, ad esempio Market in Barcelona. L'utilizzo delle virgolette intorno alla query può anche influenzare il peso assegnato a location e radius.

  • maxprice

    Limita i risultati solo ai luoghi compresi nell'intervallo specificato. I valori validi sono compresi tra 0 (più economico) e 4 (più costoso) inclusi. L'importo esatto indicato da un valore specifico varia in base alla regione.

  • minprice

    Limita i risultati solo ai luoghi compresi nell'intervallo specificato. I valori validi sono compresi tra 0 (più economico) e 4 (più costoso) inclusi. L'importo esatto indicato da un valore specifico varia in base alla regione.

  • opennow

    Restituisce solo i luoghi aperti al momento dell'invio della query. I luoghi che non specificano l'orario di apertura nel database di Google Places non verranno restituiti se includi questo parametro nella query.

  • pagetoken

    Restituisce fino a 20 risultati di una ricerca eseguita in precedenza. L'impostazione di un parametro pagetoken eseguirà una ricerca con gli stessi parametri utilizzati in precedenza. Tutti i parametri diversi da pagetoken verranno ignorati.

  • regione

    Il codice regione, specificato come valore di due caratteri ccTLD ("dominio di primo livello"). La maggior parte dei codici ccTLD è identica ai codici ISO 3166-1, con alcune eccezioni degne di nota. Ad esempio, il ccTLD del Regno Unito è "uk" (.co.uk), mentre il suo codice ISO 3166-1 è"gb " (tecnicamente per l'entità "Regno Unito di Gran Bretagna e Irlanda del Nord").

  • tipo

    Limita i risultati ai luoghi corrispondenti al tipo specificato. È possibile specificare un solo tipo. Se vengono forniti più tipi, tutti i tipi successivi alla prima voce vengono ignorati.

    • type=hospital|pharmacy|doctor diventa type=hospital
    • type=hospital,pharmacy,doctor viene ignorato completamente

    Consulta l'elenco dei tipi supportati.

    Nota: l'aggiunta di keyword e type con lo stesso valore (keyword=cafe&type=cafe o keyword=parking&type=parking) può generare ZERO_RESULTS.

Esempi di Ricerca testuale (Legacy)

Nota: in questi esempi, devi sostituire key con la tua chiave API affinché la richiesta funzioni nella tua applicazione.

Esempio di base

L'esempio seguente mostra una ricerca di ristoranti vicino a 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

Esempio di indirizzo incompleto

L'esempio seguente mostra una ricerca di un indirizzo incompleto, in questo caso un indirizzo che non include una città, uno stato o un paese.

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>

Esempio di bias di posizione

L'esempio seguente mostra una ricerca dello stesso indirizzo incompleto dell'esempio precedente e include i parametri location e radius per orientare i risultati verso una regione di interesse.

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>

Risposte di Ricerca testuale (Legacy)

Le risposte di ricerca vengono restituite nel formato indicato dal flag output all'interno del percorso della richiesta dell'URL.

L'esempio seguente mostra una risposta di Ricerca testuale (legacy).

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

Campo Obbligatorio Tipo Descrizione
required Array<string>

Può contenere un insieme di attribuzioni relative a questa scheda che devono essere mostrate all'utente (alcune schede potrebbero non avere attribuzioni).

required Array<Place>

Contiene un array di luoghi.

Le richieste Place Search restituiscono un sottoinsieme dei campi restituiti dalle richieste Place Details. Se il campo che ti interessa non viene restituito da Place Search, puoi utilizzare Place Search per ottenere un place_id, quindi utilizzare questo ID luogo per effettuare una richiesta Place Details.

Per saperne di più, consulta Place.
required PlacesSearchStatus

Contiene lo stato della richiesta e può contenere informazioni di debug per aiutarti a individuare il motivo per cui la richiesta non è andata a buon fine.

Per saperne di più, consulta PlacesSearchStatus.

facoltativo stringa

Quando il servizio restituisce un codice di stato diverso da OK<, potrebbe essere presente un campo error_message aggiuntivo all'interno dell'oggetto della risposta. Questo campo contiene informazioni più dettagliate sui motivi alla base del codice di stato specificato. Questo campo non viene sempre restituito e i suoi contenuti sono soggetti a modifiche.

facoltativo Array<string>

Quando il servizio restituisce informazioni aggiuntive sulla specifica della richiesta, potrebbe essere presente un campo info_messages aggiuntivo all'interno dell'oggetto della risposta. Questo campo viene restituito solo per le richieste andate a buon fine. Potrebbe non essere sempre restituito e i suoi contenuti sono soggetti a modifiche.

next_page_token

facoltativo stringa

Contiene un token che può essere utilizzato per restituire fino a 20 risultati aggiuntivi. Se non sono presenti altri risultati da visualizzare, non verrà restituito un token next_page_token. Il numero massimo di risultati che è possibile restituire è 60. Esiste un breve ritardo tra l'emissione di un token next_page_token e il momento in cui diventa valido.

PlacesSearchStatus

Codici di stato restituiti dal servizio.

  • OK, che indica che la richiesta API è andata a buon fine.
  • ZERO_RESULTS che indica che la ricerca è andata a buon fine, ma non ha restituito risultati. Questo può accadere se alla ricerca è stato passato un latlng in una località remota.
  • INVALID_REQUEST indica che la richiesta API non era in un formato valido, in genere a causa di un parametro di query obbligatorio mancante (location o radius).
  • OVER_QUERY_LIMIT che indica uno dei seguenti elementi:
    • Hai superato i limiti di QPS.
    • La fatturazione non è stata abilitata sul tuo account.
    • È stato superato il credito mensile di 200 $o un limite di utilizzo autoimposto.
    • Il metodo di pagamento fornito non è più valido (ad esempio, una carta di credito è scaduta).
    Per saperne di più su come risolvere questo errore, consulta le Domande frequenti su Maps.
  • REQUEST_DENIED che indica che la tua richiesta è stata rifiutata, in genere perché:
    • La richiesta non contiene una chiave API.
    • Il parametro key non è valido.
  • UNKNOWN_ERROR che indica un errore sconosciuto.

Luogo

Le risposte di Place Search restituiscono il seguente sottoinsieme di campi Place. Non tutti gli attributi sono disponibili per tutti i tipi di luoghi. Per recuperare i campi che Place Search non restituisce, ad esempio address_components, formatted_phone_number, reviews o website, passa il valore place_id restituito in una richiesta Place Details (Legacy). Per la disponibilità dei campi e i livelli di prezzo tra gli endpoint, consulta Campi di dati di Place (legacy).

Campo Tipo Descrizione
business_status string Indica lo stato di attività del luogo, se si tratta di un'attività: OPERATIONAL, CLOSED_TEMPORARILY o CLOSED_PERMANENTLY. Omesso se non esistono dati sullo stato.
formatted_address string L'indirizzo leggibile di questo luogo. Restituito da Ricerca testuale (Legacy) e Trova luogo (Legacy). Non analizzare l'indirizzo formattato in modo programmatico; richiedi invece address_components in Place Details (Legacy).
geometry Geometry Contiene il location geocodificato con le coordinate lat e lng e il viewport preferito con i limiti northeast e southwest.
icon string L'URL di un'icona suggerita che puoi mostrare quando indichi questo risultato su una mappa.
icon_background_color string Il codice colore esadecimale predefinito per la categoria del luogo.
icon_mask_base_uri string L'URL di base di un'icona consigliata, senza l'estensione del tipo di file SVG o PNG.
name string Il nome leggibile del risultato restituito. Per i risultati establishment, questo valore è in genere il nome dell'attività in formato canonico.
opening_hours PlaceOpeningHours Informazioni sull'orario di apertura. Gli endpoint di Place Search restituiscono solo il sottocampo booleano open_now; richiedi opening_hours in Place Details (Legacy) per periods e weekday_text.
permanently_closed boolean Ritirato: utilizza business_status per controllare lo stato di attività di un'attività.
photos Array<PlacePhoto> Un array di oggetti PlacePhoto, ognuno contenente photo_reference, height, width e html_attributions. Per i dettagli sull'utilizzo, consulta Foto dei luoghi (legacy).
place_id string Un identificatore testuale che identifica in modo univoco un luogo. Passa questo ID nel parametro place_id di una richiesta Place Details (Legacy). Consulta la panoramica degli ID luogo.
plus_code PlusCode Un riferimento di posizione codificato derivato dalle coordinate di latitudine e longitudine, contenente un global_code e un compound_code facoltativo.
price_level integer Il livello di prezzo del luogo su una scala da 0 a 4, dal meno costoso al più costoso. Consulta price_level.
rating number La valutazione del luogo, da 1.0 a 5.0, in base alle recensioni aggregate degli utenti.
reference string Deprecato: utilizza place_id.
scope string Deprecato: indica l'ambito di place_id, che è sempre GOOGLE. Restituito da Nearby Search (Legacy).
types Array<string> Un array di tipi di caratteristiche che descrivono il risultato specificato. Consulta Tipi di luoghi (legacy).
user_ratings_total integer Il numero totale di valutazioni, con o senza testo della recensione, per questo luogo.
vicinity string Un indirizzo semplificato del luogo, inclusi il nome della via, il numero civico e la località, senza stato o provincia, codice postale o paese. Restituito da Nearby Search (Legacy).

Accesso a risultati aggiuntivi

Per impostazione predefinita, ogni risposta restituisce fino a 20 risultati establishment per query. Tuttavia, ogni ricerca può restituire fino a 60 risultati, suddivisi in tre pagine. Se la ricerca restituisce più di 20 risultati, la risposta di ricerca includerà un valore aggiuntivo: next_page_token. Passa il valore di next_page_token al parametro pagetoken di una nuova richiesta per visualizzare il successivo insieme di risultati.

  • Se next_page_token è null o non viene restituito, non ci sono altri risultati.
  • Se ripeti la richiesta con lo stesso next_page_token, verrà restituita la pagina di risultati successiva.
  • L'impostazione di pagetoken comporterà l'ignoramento di tutti gli altri parametri.
  • Puoi richiedere una nuova pagina fino a due volte dopo la query originale.
  • Ogni richiesta, inclusa una richiesta che utilizza next_page_token, viene conteggiata come una singola richiesta ai fini dei limiti di utilizzo e viene addebitata separatamente.
  • C'è un ritardo di alcuni secondi tra l'emissione di un next_page_token e il momento in cui diventa valido. Se richiedi la pagina successiva prima che sia disponibile, verrà restituita una risposta INVALID_REQUEST. Le richieste con next_page_token vengono sempre addebitate.

Ad esempio, nella query seguente, cerchiamo ristoranti vicino a Darling Harbour, a Sydney, in Australia, e ordiniamo i risultati in base alla distanza. Puoi vedere che la risposta contiene una proprietà 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"
}

Per visualizzare il successivo insieme di risultati, puoi inviare una nuova query, passando il risultato di next_page_token al parametro pagetoken. Ad esempio: 

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