Place Autocomplete (legacy)

Place Autocomplete (legacy) è un servizio web che restituisce previsioni relative ai luoghi in risposta a una richiesta HTTP. La richiesta specifica una stringa di ricerca testuale e limiti geografici facoltativi. Il servizio può essere utilizzato per fornire la funzionalità di completamento automatico per le ricerche geografiche basate su testo, restituendo luoghi come attività commerciali, indirizzi e punti d'interesse mentre l'utente digita.

Richieste Place Autocomplete (legacy)

Place Autocomplete (legacy) fa parte dell'API Places e condivide una chiave API e quote con l'API Places.

Place Autocomplete (legacy) può trovare corrispondenze con parole intere e sottostringhe, risolvendo nomi di luoghi, indirizzi e Plus Code. Le applicazioni possono quindi inviare query mentre l'utente digita, per fornire previsioni dei luoghi al volo.

Devi formattare correttamente i plus code. Ciò significa che devi eseguire l'escape dell'URL del segno più in %2B e degli spazi in %20.

• Un codice globale è un prefisso di quattro caratteri e un codice locale di almeno sei caratteri. Ad esempio, il codice globale di escape dell'URL 849VCWC8+R9 è 849VCWC8%2BR9.
• Un codice composto è un codice locale di sei caratteri (o più) con una posizione esplicita. Ad esempio, il codice composto con escape URL CWC8+R9 Mountain View, CA, USA è CWC8%2BR9%20Mountain%20View%20CA%20USA.

Le previsioni restituite sono progettate per essere presentate all'utente per aiutarlo a selezionare il luogo che desidera. Puoi inviare una richiesta Places Details (legacy) per ulteriori informazioni su uno qualsiasi dei luoghi restituiti.

Una richiesta Place Autocomplete (legacy) è un URL HTTP nel seguente formato:

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

dove output può avere 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 Place Autocomplete (legacy), sono necessari determinati parametri. Come di consueto negli URL, tutti i parametri sono separati dal carattere e commerciale (&). L'elenco dei parametri e dei relativi valori possibili è riportato di seguito.

Parametri obbligatori

• immissione

  La stringa di testo su cui eseguire la ricerca. Il servizio Place Autocomplete restituirà corrispondenze candidate in base a questa stringa e ordinerà i risultati in base alla loro pertinenza percepita.

Parametri facoltativi

• componenti

  Un raggruppamento di luoghi a cui vuoi limitare i risultati. Puoi utilizzare i componenti per filtrare fino a 5 paesi. I paesi devono essere trasmessi come codice paese di due caratteri compatibile con ISO 3166-1 Alpha-2. Ad esempio: components=country:fr limiterebbe i risultati ai luoghi in Francia. Più paesi devono essere trasmessi come più filtri country:XX, con il carattere pipe | come separatore. Ad esempio: components=country:us|country:pr|country:vi|country:gu|country:mp limiterebbe i risultati ai luoghi all'interno degli Stati Uniti e dei loro territori organizzati non incorporati.

  Nota:se ricevi risultati imprevisti con un codice paese, verifica di utilizzare un codice che includa i paesi, i territori dipendenti e le aree di interesse geografico speciali che ti interessano. Puoi trovare informazioni sui codici su Wikipedia: List of ISO 3166 country codes o sulla ISO Online Browsing Platform.

• 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 stradale leggibile sia per l'utente sia per gli abitanti del luogo. Per raggiungere questo obiettivo, restituisce gli indirizzi stradali nella lingua locale, traslitterati in un sistema di scrittura leggibile dall'utente, se necessario, rispettando la lingua preferita. Tutti gli altri indirizzi vengono restituiti nella lingua preferita. Tutti i componenti dell'indirizzo vengono restituiti nella stessa lingua, 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 radius deve essere fornito anche quando viene specificata una località. Se radius non viene fornito, il parametro location viene ignorato.

  Quando utilizzi l'API Ricerca testuale, il parametro `location` può essere sostituito se `query` contiene una località esplicita come `Mercato a Barcellona`.

• 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 è specificato, l'API utilizza la ponderazione dell'indirizzo IP per impostazione predefinita.

  • Bias IP: indica all'API di utilizzare la ponderazione dell'indirizzo IP. Trasmetti la stringa ipbias (questa opzione non ha parametri aggiuntivi).
  • Circolare: una stringa che specifica il raggio in metri, più lat/lng 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. Nota che i valori est/ovest sono inclusi nell'intervallo -180, 180 e i valori nord/sud sono inclusi nell'intervallo -90, 90.

• locationrestriction

  Limita i risultati a un'area specificata, indicando un raggio più latitudine/longitudine o due coppie di latitudine/longitudine che rappresentano i punti di un rettangolo.

  • Circolare: una stringa che specifica il raggio in metri, più lat/lng 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. Nota che i valori est/ovest sono inclusi nell'intervallo -180, 180 e i valori nord/sud sono inclusi nell'intervallo -90, 90.

• offset

  La posizione, nel termine di input, dell'ultimo carattere che il servizio utilizza per trovare le corrispondenze delle previsioni. Ad esempio, se l'input è Google e l'offset è 3, il servizio troverà una corrispondenza con Goo. La stringa determinata dall'offset viene confrontata con solo la prima parola del termine di input. Ad esempio, se il termine di input è Google abc e l'offset è 3, il servizio tenterà di trovare una corrispondenza con Goo abc. Se non viene fornito alcun offset, il servizio utilizzerà l'intero periodo. L'offset deve essere generalmente impostato sulla posizione del cursore di testo.

• origine

  Il punto di origine da cui calcolare la distanza in linea retta fino alla destinazione (restituita come distance_meters). Se questo valore viene omesso, la distanza in linea retta non verrà restituita. Deve essere specificato come latitude,longitude.

• raggio

  Definisce la distanza (in metri) entro la quale restituire i risultati dei luoghi. Puoi orientare i risultati verso un cerchio specificato passando un parametro location e un parametro radius. In questo modo, il servizio Places preferisce mostrare i risultati all'interno di questo 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 raggio non verrà accettato e verrà visualizzato un INVALID_REQUEST.
  • Query Autocomplete: 50.000 metri
  • Ricerca testuale: 50.000 metri

• regione

  Il codice regione, specificato come valore di due caratteri ccTLD ("top-level domain"). La maggior parte dei codici ccTLD sono identici ai codici ISO 3166-1, con alcune eccezioni degne di nota. Ad esempio, il TLD specifico per paese 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").

• sessiontoken

  Una stringa casuale che identifica una sessione di completamento automatico ai fini della fatturazione.

  La sessione inizia quando l'utente inizia a digitare una query e termina quando seleziona un luogo e viene effettuata una chiamata a Place Details. Ogni sessione può avere più query, seguite dalla selezione di un luogo. Le chiavi API utilizzate per ogni richiesta all'interno di una sessione devono appartenere allo stesso progetto Google Cloud Console. Una volta terminata una sessione, il token non è più valido; la tua app deve generare un nuovo token per ogni sessione. Se il parametro sessiontoken viene omesso o se riutilizzi un token di sessione, la sessione viene addebitata come se non fosse stato fornito alcun token di sessione (ogni richiesta viene fatturata separatamente).

  Ti consigliamo di seguire le seguenti linee guida:

  • Utilizza i token di sessione per tutte le sessioni Autocomplete.
  • Genera un nuovo token per ogni sessione. Si consiglia l'uso di UUID versione 4.
  • Assicurati che le chiavi API utilizzate per tutte le richieste Place Autocomplete e Place Details all'interno di una sessione appartengano allo stesso progetto Cloud Console.
  • Assicurati di trasmettere un token di sessione univoco per ogni nuova sessione. L'utilizzo dello stesso token per più sessioni comporterà l'addebito individuale di ogni richiesta.

• strictbounds

  Restituisce solo i luoghi che si trovano rigorosamente all'interno della regione definita da location e radius. Si tratta di una limitazione, piuttosto che di un bias, il che significa che i risultati al di fuori di questa regione non verranno restituiti anche se corrispondono all'input dell'utente.

• tipi

  Puoi limitare i risultati di una richiesta di Place Autocomplete a un determinato tipo passando il parametro types. Questo parametro specifica un tipo o una raccolta di tipi, come elencato in Tipi di luoghi. Se non viene specificato nulla, vengono restituiti tutti i tipi.

  Un luogo può avere un solo tipo principale tra quelli elencati nella tabella 1 o nella tabella 2. Ad esempio, un hotel in cui viene servito cibo potrebbe essere restituito solo con types=lodging e non con types=restaurant.

  Per il valore del parametro types puoi specificare:

  • Fino a cinque valori da Tabella 1 o Tabella 2. Per più valori, separa ogni valore con una | (barra verticale). Ad esempio:

    types=book_store|cafe

  • Qualsiasi singolo filtro supportato nella Tabella 3. Non puoi combinare le raccolte di tipi.

  La richiesta verrà rifiutata con un errore INVALID_REQUEST se:

  • Sono stati specificati più di cinque tipi.
  • Sono presenti tipi non riconosciuti.
  • Qualsiasi tipo di Tabella 1 o Tabella 2 viene combinato con uno qualsiasi dei filtri della Tabella 3.

Esempi di Place Autocomplete (legacy)

Una richiesta di attività contenenti la stringa "Amoeba" all'interno di un'area centrata su San Francisco, CA:

https://maps.googleapis.com/maps/api/place/autocomplete/json
      ?input=amoeba
      &types=establishment
      &location=37.76999%2C-122.44696
      &radius=500
      &key=YOUR_API_KEY

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/autocomplete/json?input=amoeba&types=establishment&location=37.76999%2C-122.44696&radius=500&key=YOUR_API_KEY'

La stessa richiesta, limitata ai risultati entro 500 metri da Ashbury St e Haight St, San Francisco:

https://maps.googleapis.com/maps/api/place/autocomplete/json
      ?input=amoeba
      &types=establishment
      &location=37.76999%2C-122.44696&radius=500
      &strictbounds=true
      &key=YOUR_API_KEY

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/autocomplete/json?input=amoeba&types=establishment&location=37.76999%2C-122.44696&radius=500&strictbounds=true&key=YOUR_API_KEY'

Una richiesta di indirizzi contenenti "Vict" con risultati in francese:

https://maps.googleapis.com/maps/api/place/autocomplete/json
      ?input=Vict
      &types=geocode
      &language=fr
      &key=YOUR_API_KEY

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/autocomplete/json?input=Vict&types=geocode&language=fr&key=YOUR_API_KEY'

Una richiesta di città contenenti "Vict" con risultati in portoghese brasiliano:

https://maps.googleapis.com/maps/api/place/autocomplete/json
      ?input=Vict
      &types=(cities)
      &language=pt_BR&key=YOUR_API_KEY

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/autocomplete/json?input=Vict&types=(cities)&language=pt_BR&key=YOUR_API_KEY'

Tieni presente che dovrai sostituire la chiave API in questi esempi con la tua chiave.

Risposta di Place Autocomplete (legacy)

Le risposte di Place Autocomplete (legacy) vengono restituite nel formato indicato dal flag output all'interno del percorso dell'URL della richiesta. I risultati riportati di seguito sono indicativi di ciò che potrebbe essere restituito per una query con i seguenti parametri:

https://maps.googleapis.com/maps/api/place/autocomplete/json
      ?input=Paris
      &types=geocode
      &key=YOUR_API_KEY

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/autocomplete/json?input=Paris&types=geocode&key=YOUR_API_KEY'

{
  "predictions":
    [
      {
        "description": "Paris, France",
        "matched_substrings": [{ "length": 5, "offset": 0 }],
        "place_id": "ChIJD7fiBh9u5kcRYJSMaMOCCwQ",
        "reference": "ChIJD7fiBh9u5kcRYJSMaMOCCwQ",
        "structured_formatting":
          {
            "main_text": "Paris",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "France",
          },
        "terms":
          [
            { "offset": 0, "value": "Paris" },
            { "offset": 7, "value": "France" },
          ],
        "types": ["locality", "political", "geocode"],
      },
      {
        "description": "Paris, TX, USA",
        "matched_substrings": [{ "length": 5, "offset": 0 }],
        "place_id": "ChIJmysnFgZYSoYRSfPTL2YJuck",
        "reference": "ChIJmysnFgZYSoYRSfPTL2YJuck",
        "structured_formatting":
          {
            "main_text": "Paris",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "TX, USA",
          },
        "terms":
          [
            { "offset": 0, "value": "Paris" },
            { "offset": 7, "value": "TX" },
            { "offset": 11, "value": "USA" },
          ],
        "types": ["locality", "political", "geocode"],
      },
      {
        "description": "Paris, TN, USA",
        "matched_substrings": [{ "length": 5, "offset": 0 }],
        "place_id": "ChIJ4zHP-Sije4gRBDEsVxunOWg",
        "reference": "ChIJ4zHP-Sije4gRBDEsVxunOWg",
        "structured_formatting":
          {
            "main_text": "Paris",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "TN, USA",
          },
        "terms":
          [
            { "offset": 0, "value": "Paris" },
            { "offset": 7, "value": "TN" },
            { "offset": 11, "value": "USA" },
          ],
        "types": ["locality", "political", "geocode"],
      },
      {
        "description": "Paris, Brant, ON, Canada",
        "matched_substrings": [{ "length": 5, "offset": 0 }],
        "place_id": "ChIJsamfQbVtLIgR-X18G75Hyi0",
        "reference": "ChIJsamfQbVtLIgR-X18G75Hyi0",
        "structured_formatting":
          {
            "main_text": "Paris",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "Brant, ON, Canada",
          },
        "terms":
          [
            { "offset": 0, "value": "Paris" },
            { "offset": 7, "value": "Brant" },
            { "offset": 14, "value": "ON" },
            { "offset": 18, "value": "Canada" },
          ],
        "types": ["neighborhood", "political", "geocode"],
      },
      {
        "description": "Paris, KY, USA",
        "matched_substrings": [{ "length": 5, "offset": 0 }],
        "place_id": "ChIJsU7_xMfKQ4gReI89RJn0-RQ",
        "reference": "ChIJsU7_xMfKQ4gReI89RJn0-RQ",
        "structured_formatting":
          {
            "main_text": "Paris",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "KY, USA",
          },
        "terms":
          [
            { "offset": 0, "value": "Paris" },
            { "offset": 7, "value": "KY" },
            { "offset": 11, "value": "USA" },
          ],
        "types": ["locality", "political", "geocode"],
      },
    ],
  "status": "OK",
}

    
<?xml version="1.0" encoding="UTF-8"?>
<AutocompletionResponse>
 <status>OK</status>
 <prediction>
  <description>Paris, France</description>
  <type>locality</type>
  <type>political</type>
  <type>geocode</type>
  <reference>ChIJD7fiBh9u5kcRYJSMaMOCCwQ</reference>
  <term>
   <value>Paris</value>
   <offset>0</offset>
  </term>
  <term>
   <value>France</value>
   <offset>7</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <place_id>ChIJD7fiBh9u5kcRYJSMaMOCCwQ</place_id>
  <structured_formatting>
   <description>Paris</description>
   <subdescription>France</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
  </structured_formatting>
 </prediction>
 <prediction>
  <description>Paris, TX, USA</description>
  <type>locality</type>
  <type>political</type>
  <type>geocode</type>
  <reference>ChIJmysnFgZYSoYRSfPTL2YJuck</reference>
  <term>
   <value>Paris</value>
   <offset>0</offset>
  </term>
  <term>
   <value>TX</value>
   <offset>7</offset>
  </term>
  <term>
   <value>USA</value>
   <offset>11</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <place_id>ChIJmysnFgZYSoYRSfPTL2YJuck</place_id>
  <structured_formatting>
   <description>Paris</description>
   <subdescription>TX, USA</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
  </structured_formatting>
 </prediction>
 <prediction>
  <description>Paris, TN, USA</description>
  <type>locality</type>
  <type>political</type>
  <type>geocode</type>
  <reference>ChIJ4zHP-Sije4gRBDEsVxunOWg</reference>
  <term>
   <value>Paris</value>
   <offset>0</offset>
  </term>
  <term>
   <value>TN</value>
   <offset>7</offset>
  </term>
  <term>
   <value>USA</value>
   <offset>11</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <place_id>ChIJ4zHP-Sije4gRBDEsVxunOWg</place_id>
  <structured_formatting>
   <description>Paris</description>
   <subdescription>TN, USA</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
  </structured_formatting>
 </prediction>
 <prediction>
  <description>Paris, Brant, ON, Canada</description>
  <type>neighborhood</type>
  <type>political</type>
  <type>geocode</type>
  <reference>ChIJsamfQbVtLIgR-X18G75Hyi0</reference>
  <term>
   <value>Paris</value>
   <offset>0</offset>
  </term>
  <term>
   <value>Brant</value>
   <offset>7</offset>
  </term>
  <term>
   <value>ON</value>
   <offset>14</offset>
  </term>
  <term>
   <value>Canada</value>
   <offset>18</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <place_id>ChIJsamfQbVtLIgR-X18G75Hyi0</place_id>
  <structured_formatting>
   <description>Paris</description>
   <subdescription>Brant, ON, Canada</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
  </structured_formatting>
 </prediction>
 <prediction>
  <description>Paris, KY, USA</description>
  <type>locality</type>
  <type>political</type>
  <type>geocode</type>
  <reference>ChIJsU7_xMfKQ4gReI89RJn0-RQ</reference>
  <term>
   <value>Paris</value>
   <offset>0</offset>
  </term>
  <term>
   <value>KY</value>
   <offset>7</offset>
  </term>
  <term>
   <value>USA</value>
   <offset>11</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <place_id>ChIJsU7_xMfKQ4gReI89RJn0-RQ</place_id>
  <structured_formatting>
   <description>Paris</description>
   <subdescription>KY, USA</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
  </structured_formatting>
 </prediction>
</AutocompletionResponse>

   

PlacesAutocompleteResponse

All'interno dei risultati, sono particolarmente interessanti gli elementi place_id, che possono essere utilizzati per richiedere dettagli più specifici sul luogo utilizzando una query separata. Vedi Richieste Place Details (legacy).

Una risposta XML è costituita da un singolo elemento <AutocompletionResponse> con due tipi di elementi secondari:

• Un singolo elemento <status> contiene metadati sulla richiesta. Vedi Codici di stato di seguito.
• Zero o più elementi <prediction>, ognuno dei quali contiene informazioni su un singolo luogo. Consulta Risultati di Place Autocomplete (legacy) per informazioni su questi risultati. L'API Places restituisce fino a 5 risultati.

Ti consigliamo di utilizzare json come flag di output preferito a meno che la tua applicazione non richieda xml per qualche motivo. L'elaborazione degli alberi XML richiede attenzione, in modo da fare riferimento ai nodi e agli elementi corretti. Consulta Elaborazione di XML con XPath per informazioni sull'elaborazione di XML.

PlacesAutocompleteStatus

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. Ciò può verificarsi se nella ricerca sono stati passati limiti in una posizione remota.
• INVALID_REQUEST che indica che la richiesta API non è formattata correttamente, in genere a causa del parametro input mancante.
• OVER_QUERY_LIMIT che indica uno dei seguenti elementi:
  • Hai superato i limiti di QPS.
  • La fatturazione non è stata abilitata sul tuo account.
  • Il credito mensile di 200 $o un limite di utilizzo autoimposto è stato superato.
  • 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 include una chiave API.
  • Il parametro key non è valido.
• UNKNOWN_ERROR che indica un errore sconosciuto.

Quando il servizio Places restituisce risultati JSON da una ricerca, li inserisce in un array predictions. Anche se il servizio non restituisce risultati (ad esempio se location è remoto), restituisce comunque un array predictions vuoto. Le risposte XML sono costituite da zero o più elementi <prediction>.

PlaceAutocompletePrediction

PlaceAutocompleteMatchedSubstring

PlaceAutocompleteStructuredFormat

PlaceAutocompleteTerm

Ottimizzazione di Place Autocomplete (legacy)

Questa sezione descrive le best practice per aiutarti a sfruttare al meglio il servizio Place Autocomplete (legacy).

Ecco alcune linee guida generali:

• Il modo più rapido per sviluppare un'interfaccia utente funzionante è utilizzare il widget Place Autocomplete (legacy) dell'API Maps JavaScript , il widget Place Autocomplete (legacy) di Places SDK for Android o il controllo UI Place Autocomplete (legacy) di Places SDK for iOS .
• Comprendi i campi di dati essenziali di Place Autocomplete (legacy) fin dall'inizio.
• I campi di distorsione della località e limitazione della località sono facoltativi, ma possono avere un impatto significativo sulle prestazioni del completamento automatico.
• Utilizza la gestione degli errori per assicurarti che la tua app funzioni correttamente se l'API restituisce un errore.
• Assicurati che la tua app gestisca i casi in cui non viene effettuata alcuna selezione e offra agli utenti un modo per continuare.

Best practice per l'ottimizzazione dei costi

Ottimizzazione di base dei costi

Per ottimizzare il costo dell'utilizzo del servizio Place Autocomplete (legacy), utilizza le maschere dei campi nei widget Place Details (legacy) e Place Autocomplete (legacy) per restituire solo i campi di dati di Place Autocomplete (legacy) di cui hai bisogno.

Ottimizzazione avanzata dei costi

Valuta l'implementazione programmatica di Place Autocomplete (legacy) per accedere al prezzo dello SKU: Autocomplete - Per Request e richiedi i risultati dell'API Geocoding sul luogo selezionato anziché su Place Details (legacy). Il prezzo per richiesta abbinato all'API Geocoding è più conveniente del prezzo per sessione (basato sulla sessione) se vengono soddisfatte entrambe le seguenti condizioni:

• Se hai bisogno solo della latitudine/longitudine o dell'indirizzo del luogo selezionato dall'utente, l'API Geocoding fornisce queste informazioni a un costo inferiore rispetto a una chiamata a Place Details (legacy).
• Se gli utenti selezionano una previsione di completamento automatico entro una media di quattro o meno richieste di Place Autocomplete (legacy), i prezzi per richiesta potrebbero essere più convenienti rispetto ai prezzi per sessione.

La tua applicazione richiede informazioni diverse dall'indirizzo e dalla latitudine/longitudine della previsione selezionata?

Best practice per le prestazioni

Le seguenti linee guida descrivono i modi per ottimizzare il rendimento di Place Autocomplete (legacy):

• Aggiungi limitazioni in base al paese, priorità alla località, e (per le implementazioni programmatiche) preferenza della lingua all'implementazione di Place Autocomplete (legacy). La preferenza della lingua non è necessaria con i widget, poiché questi scelgono le preferenze della lingua dal browser o dal dispositivo mobile dell'utente.
• Se Place Autocomplete (legacy) è accompagnato da una mappa, puoi impostare la posizione in base all'area visibile della mappa.
• Nelle situazioni in cui un utente non sceglie una delle previsioni di Place Autocomplete (legacy), in genere perché nessuna di queste previsioni è l'indirizzo del risultato desiderato, puoi riutilizzare l'input originale dell'utente per tentare di ottenere risultati più pertinenti:
  • Se prevedi che l'utente inserisca solo informazioni sull'indirizzo, riutilizza l'input utente originale in una chiamata all'API Geocoding.
  • Se prevedi che l'utente inserisca query per un luogo specifico per nome o indirizzo, utilizza una richiesta Dettagli luogo (legacy). Se i risultati sono previsti solo in una regione specifica, utilizza la priorità della località.
  Altri scenari in cui è meglio ricorrere all'API Geocoding includono:
  • Utenti che inseriscono indirizzi di locali secondari, ad esempio indirizzi di unità o appartamenti specifici all'interno di un edificio. Ad esempio, l'indirizzo ceco "Stroupežnického 3191/17, Praha" restituisce una previsione parziale in Place Autocomplete (legacy).
  • Utenti che inseriscono indirizzi con prefissi di segmenti stradali come "23-30 29th St, Queens" a New York City o "47-380 Kamehameha Hwy, Kaneohe" sull'isola di Kauai nelle Hawaii.

Bias di località

Inclina i risultati verso un'area specificata passando un parametro location e un parametro radius. In questo modo, il completamento automatico dei luoghi (legacy) preferisce mostrare i risultati all'interno dell'area definita. I risultati al di fuori dell'area definita potrebbero comunque essere visualizzati. Puoi utilizzare il parametro includedRegionCodes per filtrare i risultati in modo da mostrare solo i luoghi all'interno di un paese specifico.

Limitazione della località

Limita i risultati a un'area specificata passando un parametro locationRestriction.

Puoi anche limitare i risultati alla regione definita da location e da un parametro radius, aggiungendo il parametro strictbounds. In questo modo, Place Autocomplete (legacy) restituisce solo i risultati all'interno di quella regione.