Trova luogo (legacy)

Una richiesta Find Place (Legacy) accetta un input di testo e restituisce un luogo. L'input può essere qualsiasi tipo di dati di testo di Places, ad esempio un nome, un indirizzo o un numero di telefono. La richiesta deve essere una stringa. Una richiesta Find Place (Legacy) che utilizza dati non di tipo stringa, come coordinate di latitudine/longitudine o un Plus Code, genera un errore.

Richieste Find Place (Legacy)

Una richiesta Find Place (Legacy) è un URL HTTP nel seguente formato:

https://maps.googleapis.com/maps/api/place/findplacefromtext/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 Find Place (Legacy) sono necessari alcuni parametri. Come è standard negli URL, tutti i parametri sono separati utilizzando il carattere e commerciale (&).

Parametri obbligatori

• input

  La stringa di testo in cui cercare. Deve essere un nome, un indirizzo o un numero di telefono di un luogo (ad esempio, "Via Roma 123" o "Municipio").

• inputtype

  Il tipo di input. Può essere textquery o phonenumber. I numeri di telefono devono essere in formato internazionale (preceduti da un segno più "+", seguito dal codice paese e poi dal numero di telefono stesso). Per saperne di più, consulta la raccomandazione ITU E.164.

Parametri facoltativi

• i campi

  Attenzione:le richieste Place Search (Legacy) e Place Details (Legacy) non restituiscono gli stessi campi. Le richieste Place Search (Legacy) restituiscono un sottoinsieme dei campi restituiti dalle richieste Place Details (Legacy). Se il campo che ti interessa non viene restituito da Place Search (Legacy), puoi utilizzare Place Search (Legacy) per ottenere un place_id, quindi utilizzare questo ID luogo per effettuare una richiesta Place Details (Legacy). Per saperne di più sui campi non disponibili in una richiesta Place Search (Legacy), consulta Supporto dei campi dell'API Places.

  Utilizza il parametro fields per specificare un elenco separato da virgole dei tipi di dati dei luoghi da restituire. Ad esempio: fields=formatted_address,name,geometry. Utilizza una barra quando specifichi valori composti. Ad esempio: opening_hours/open_now.

  I campi sono suddivisi in tre categorie di fatturazione: Basic, Contact e Atmosphere. I campi di base vengono fatturati alla tariffa di base, mentre i campi Contatto e Atmosfera vengono fatturati a una tariffa più elevata. Gli SKU Basic, Contact e Atmosphere vengono addebitati in aggiunta allo SKU di base (Place Details, Find Place, Nearby Search o Ricerca testuale) per la richiesta che li ha attivati. Per saperne di più, consulta il listino prezzi.

  Basic

  La categoria Base include i seguenti campi: address_components, adr_address, business_status, formatted_address, geometry, icon, icon_mask_base_uri, icon_background_color, name, permanently_closed (ritirato), photo, place_id, plus_code, type, url, utc_offset, vicinity, wheelchair_accessible_entrance.

  Contatto

  La categoria Contatto include i seguenti campi: current_opening_hours, formatted_phone_number, international_phone_number, opening_hours, secondary_opening_hours, website

  Atmosfera

  La categoria Atmosfera include i seguenti campi: curbside_pickup, delivery, dine_in, editorial_summary, price_level, rating, reservable, reviews, serves_beer, serves_breakfast, serves_brunch, serves_dinner, serves_lunch, serves_vegetarian_food, serves_wine, takeout, user_ratings_total.

  Nota: le attribuzioni, html_attributions, vengono sempre restituite con ogni chiamata, indipendentemente dal fatto che il campo sia stato richiesto.

• 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.

• locationbias

  Preferisci i risultati in un'area specificata, indicando un raggio più latitudine/longitudine o due coppie di latitudine/longitudine che rappresentano i punti di un rettangolo. Se questo parametro non viene specificato, l'API utilizza la selezione in base all'indirizzo IP per impostazione predefinita.

  • IP bias: indica all'API di utilizzare il biasing degli indirizzi IP. Passa la stringa ipbias (questa opzione non ha parametri aggiuntivi).
  • Circolare: una stringa che specifica il raggio in metri, più latitudine/longitudine in gradi decimali. Utilizza il formato seguente: circle:radius@lat,lng.
  • Rettangolare: una stringa che specifica due coppie di latitudine/longitudine in gradi decimali, che rappresentano i punti sud/ovest e nord/est di un rettangolo. Utilizza il seguente formato:rectangle:south,west|north,east. Tieni presente che i valori est/ovest sono limitati all'intervallo -180, 180 e i valori nord/sud sono limitati all'intervallo -90, 90.

Esempi di Find Place (Legacy)

L'esempio seguente mostra una richiesta Find Place (Legacy) per "Museum of Contemporary Art Australia", inclusi i campi photos, formatted_address, name, rating, opening_hours e geometry:

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Museum%20of%20Contemporary%20Art%20Australia
    &inputtype=textquery
    &key=YOUR_API_KEY

L'esempio seguente mostra una richiesta Find Place (Legacy) per "Mongolian Grill", utilizzando il parametro locationbias per preferire i risultati entro 2000 metri dalle coordinate specificate:

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Mongolian%20Grill&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&locationbias=circle:2000@−33.866,151.216&key=YOUR_API_KEY'

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Mongolian%20Grill
    &inputtype=textquery
    &locationbias=circle:2000@−33.866,151.216
    &key=YOUR_API_KEY

L'esempio seguente mostra una richiesta Find Place (Legacy) per un numero di telefono. Tieni presente che il prefisso per le chiamate internazionali "+" è stato codificato come %2B in modo che questa richiesta sia un URL conforme. Se non viene codificato, il prefisso + viene decodificato in uno spazio sul server, il che comporta una ricerca del numero di telefono non valida.

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=%2B16502530000&inputtype=phonenumber&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=%2B16502530000
    &inputtype=phonenumber
    &key=YOUR_API_KEY

Risposte di Find Place (Legacy)

Una risposta di Find Place (Legacy) contiene solo i tipi di dati specificati utilizzando il parametro fields, oltre a html_attributions. L'esempio seguente mostra la risposta per una richiesta Find Place (Legacy) per "Museum of Contemporary Art Australia", inclusi i campi formatted_address, geometry, name, opening_hours, photos, rating.

{
  "candidates":
    [
      {
        "formatted_address": "140 George St, The Rocks NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8599358, "lng": 151.2090295 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85824377010728, "lng": 151.2104386798927 },
                "southwest":
                  { "lat": -33.86094342989272, "lng": 151.2077390201073 },
              },
          },
        "name": "Museum of Contemporary Art Australia",
        "opening_hours": { "open_now": false },
        "rating": 4.4,
      },
    ],
  "status": "OK",
}    

<?xml version="1.0" encoding="UTF-8"?>
<FindPlaceFromTextResponse>
 <candidates>
  <name>Museum of Contemporary Art Australia</name>
  <formatted_address>140 George St, The Rocks NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8599358</lat>
    <lng>151.2090295</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8609434</lat>
     <lng>151.2077390</lng>
    </southwest>
    <northeast>
     <lat>-33.8582438</lat>
     <lng>151.2104387</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.4</rating>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
 </candidates>
 <status>OK</status>
</FindPlaceFromTextResponse>

    

PlacesFindPlaceFromTextResponse

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