Questo articolo illustra come risolvere i problemi con il backend di Search relativo alle ricerche di posizioni. La ricerca della sede si ottiene impostando un filtro dedotto su builtin.location e restituisce risultati in base alla distanza dall'utente o dalla sede nella query di Search.

Assicurati di seguire l'articolo di assistenza Come iniziare il debug dei problemi del backend di Search per i passaggi generali di risoluzione dei problemi. Una volta risolto il problema, puoi saltare i passaggi rimanenti.

 

Passaggi generali per la risoluzione dei problemi

Se la ricerca della sede non sembra funzionare, inizia con i passaggi per la risoluzione dei problemi riportati di seguito. Se un passaggio risolve il problema, potrebbe non essere necessario eseguire i passaggi rimanenti.

1. Apri il registro di ricerca per la query per la quale sta riscontrando problemi, oppure:
   1. Accedi a Ricerca > [[Experience Name]] > Ricerca di prova oppure a una sottoscheda Configurazione. Esegui una ricerca di prova e seleziona Debug Query dal menu a discesa.
   2. Se ha già eseguito la ricerca in un link di gestione temporanea o di produzione, vai a Ricerca > [[Experience Name]] > Registri di ricerca e fai clic sul registro di ricerca pertinente. Utilizza la barra di ricerca o i filtri per trovare più facilmente il registro di ricerca corretto oppure esegui nuovamente la ricerca per visualizzarlo in cima.
2. Controlla il rilevamento della posizione: nei metadati del registro di Search, verifica cosa viene rilevato come posizione dell'utente. Se non è corretta, assicurati di consentire il rilevamento della posizione nel tuo browser, quindi esegui nuovamente la ricerca e controlla il nuovo registro di Search. Se è ancora errato, invia un ticket all'assistenza.
3. Verifica i filtri dedotti: nel registro di ricerca, verifica se è stato applicato un filtro dedotto su  builtin.location per il verticale pertinente.
   1. In caso contrario, verifica che il filtro dedotto sia attivato per il campo andando a Search > [[Experience Name]] > Verticali. Fai clic sulla scheda Filtri. Aggiungi il campo ricercabile, fai clic su Salva, quindi esegui nuovamente la ricerca in Ricerca di prova sul lato destro.
   2. Se hai già attivato un filtro dedotto per builtin.location, controlla se c'è un conflitto di filtri dedotti, dove verrà applicato un solo filtro dedotto, ad esempio tra la ricerca della sede e un sottocampo di sede come address.region. Puoi impostare un ordine di filtro dedotto per risolvere i conflitti tra i campi. Se il conflitto ha una priorità superiore alla ricerca della sede, dovrà essere rimosso se vuoi che la ricerca della sede venga applicata.
4. Controlla le restrizioni paese: controlla che la tua configurazione includa i paesi pertinenti per la ricerca, che per impostazione predefinita sono solo gli Stati Uniti.
   1. Vai a Ricerca > [[Experience Name]] > Impostazioni generali.
   2. Verifica che il campo Restrizioni paese includa tutti i paesi che dovrebbero essere ricercabili.
5. Controlla il riquadro di delimitazione: controlla se la tua configurazione specifica un riquadro di delimitazione e se la regione ricercabile desiderata è contenuta in tale riquadro. I riquadri di delimitazione limiteranno le ricerche a una particolare area geografica.
   1. Vai a Search > [[Experience Name]] > Modifica come JSON.
   2. Utilizza uno strumento come bboxfinder per mappare qualsiasi riquadro di delimitazione esistente. Conferma che questo includa la regione geografica necessaria.
   3. Se attualmente non esiste un riquadro di delimitazione, valuta di aggiungerne uno se si tratta di un'azienda locale di una regione, per migliorare l'accuratezza dei risultati di ricerca.
6. Verifica l'esistenza di risultati: verifica che la sede ricercata abbia delle entità vicine che rientrano nel raggio di ricerca.
   1. Vai a Search > [[Experience Name]] > Modifica come JSON. Verifica se è impostato un raggio di posizione minimo (minLocationRadius) (questo numero sarebbe espresso in metri). Se non diversamente specificato, il valore predefinito è 25 miglia.
   2. Esegui una ricerca verticale generica per restituire tutti i risultati (ad esempio, esegui una ricerca per il tipo di entità) e verifica se ci sono entità restituite nelle vicinanze, in particolare entro il raggio trovato sopra.
   3. Puoi anche controllare le entità sulla piattaforma. Vai a Knowledge Graph > Entità e filtra per il nome dello stato/regione o del paese per trovare le posizioni vicine.
7. Verifica gli override di formazione sull'esperienza: il filtro dedotto desiderato non apparirà se è stato rifiutato o se è stato approvato un altro filtro dedotto per la stessa query di ricerca.
   1. Vai a Search > [[Experience Name]] > Filtri dedotti.
   2. Utilizzi la barra di ricerca per filtrare il termine di ricerca che sta risolvendo.
   3. Fai clic per attivare l'interruttore per "Mostra voci completate".
   4. Verifica se ci sono voci relative a filtri dedotti per il verticale pertinente.
      1. Se un filtro dedotto della sede fosse rifiutato per la sede desiderata, tale filtro non verrebbe applicato a questa query di Search. Se desideri che venga applicato, annulla l'override della formazione sull'esperienza completata.
      2. Se è stato approvato un filtro dedotto diverso, non verrà applicato per la sede desiderata.
         1. Annulla il filtro errato.
         2. Disattiva "Mostra voci completate".
         3. Approva il risultato desiderato facendo clic sul segno di spunta verde accanto ad esso.
      3. Se ci sono più override attivi, annulla quelli indesiderati in modo che ne rimanga solo uno attivo.

 

Non riesco a trovare posizioni al di fuori degli Stati Uniti

Place Search esegue ricerche solo nei paesi elencati in countryRestrictions. Se questo campo non è compilato, per impostazione predefinita verrà eseguita la ricerca solo negli Stati Uniti.

1. Vai a Ricerca > [[Experience Name]] > Impostazioni generali.
2. Verifica che il campo countryRestrictions sia compilato con i paesi che desideri includere nella ricerca e aggiungi eventuali paesi mancanti.

Per ulteriori informazioni, consulta countryRestrictions nel documento API di configurazione di Answers e l'unità delle impostazioni verticali aggiuntive.

 

La ricerca della sede ha selezionato l'opzione errata tra due luoghi con lo stesso nome

Leggi come l'algoritmo di ricerca della posizione utilizza il bias di prossimità e la prominenza del luogo per scegliere tra due luoghi con nomi identici nel documento di riferimento sugli algoritmi di ricerca.

Impostare un riquadro di delimitazione e restrizioni paese aiuterà a migliorare l'accuratezza dei risultati limitando l'ambito della ricerca a una particolare regione. Controllare i passaggi generali per la risoluzione dei problemi sopra per sapere come procedere.

 

Ho cercato una città specifica, ma sedi di altre città vengono visualizzate o appaiono più in alto

La ricerca per sede funziona trovando la latitudine e la longitudine centrali del token di ricerca, ad esempio una città, e quindi restituendo le sedi più vicine a quella latitudine e longitudine. Se le sedi di altre città si trovano nel raggio di ricerca, verranno visualizzate anche loro. Ci possono essere casi in cui le sedi in una città diversa siano più vicine al centro città rispetto alle sedi in quella stessa città, e quindi appariranno più in alto nei risultati. Per ulteriori dettagli sull'algoritmo di ricerca delle sedi, consulta l'articolo di riferimento Algoritmi di ricerca.

Se desideri filtrare per mostrare solo le località nel token cercato, imposta un filtro dedotto per quel sottocampo dell'indirizzo, ad esempio address.city, che i filtri dedotti trattano come campi regolari:

1. Fai clic su Cerca nella barra di navigazione, poi fai clic sull'esperienza di ricerca desiderata. Accederai alla schermata Verticali.
2. Seleziona il verticale a cui desideri aggiungere campi ricercabili.
3.  Nella scheda Filtri , trova il riquadro per Filtri dedotti.
4. Fai clic su + Aggiungi/Aggiorna campi.
5. Nella barra di ricerca, digita address. per visualizzare i possibili sottocampi degli indirizzi e selezionare quello che desideri utilizzare, quindi fai clic su Aggiorna campi.
6. Nella tabella dei Campi disponibili per la ricerca, attiva il filtro dedotto per il campo appena aggiunto e disattivalo per builtin.location, se lo desideri.