Panoramica della ricerca lungo il percorso

Le funzionalità di ricerca lungo il percorso sono disponibili nelle seguenti API Places (New):

• Solo Ricerca testuale (New):cerca luoghi lungo un percorso di viaggio predefinito.
• Ricerca testuale (New) e Ricerca nelle vicinanze (New): calcola il riepilogo del percorso da una località di origine del percorso specificata a ogni luogo nei risultati di ricerca.
• Solo Ricerca testuale (New):calcola il riepilogo del percorso per ogni luogo lungo un percorso di viaggio predefinito.

Cercare lungo un percorso

Utilizza l'API Routes per calcolare il percorso di viaggio tra due località. L'API Routes può calcolare un percorso per un'auto, una bicicletta, un veicolo a due ruote, un sistema di trasporto pubblico o per spostarsi a piedi.

Nota:i percorsi dei sistemi di trasporto pubblico non sono supportati dall'API Places.

La Ricerca testuale (New) ti consente di utilizzare questo percorso calcolato per eseguire una ricerca lungo un percorso. Con questa opzione, passi il percorso precalcolato dall'API Routes alla richiesta di Ricerca testuale (New). La risposta contiene quindi i luoghi che corrispondono ai criteri di ricerca e che si trovano anche vicino al percorso specificato.

La ricerca lungo un percorso è simile all'utilizzo delle opzioni di richiesta locationRestriction o locationBias per influenzare i risultati di ricerca. locationRestriction restituisce i risultati di ricerca che rientrano nei limiti del riquadro visibile, mentre locationBias può restituire risultati di ricerca al di fuori del riquadro visibile. Tuttavia, mentre le opzioni locationBias e locationRestriction ti consentono di specificare una regione per influenzare i risultati di ricerca, la funzionalità di ricerca lungo il percorso nella Ricerca testuale ti consente anche di influenzare i risultati di ricerca in modo da includere quelli con tempi di deviazione minimi dall'origine del percorso alla destinazione del percorso. Puoi influenzare i risultati di ricerca utilizzando locationBias o locationRestriction in combinazione con la polilinea.

Ad esempio, considera il percorso dall'origine, denominata waypoint nell'API Routes, alla destinazione calcolata dall'API Routes:

Quando cerchi lungo il percorso, la ricerca è influenzata in modo da restituire i luoghi vicino al percorso con tempi di deviazione minimi dall'origine alla destinazione. In questo esempio, i punti A, B e C sono i luoghi restituiti dalla ricerca.

Calcolare il riepilogo del percorso

La Ricerca testuale (New) e la Ricerca nelle vicinanze (New) possono calcolare il riepilogo del percorso, ovvero la durata e la distanza, per ogni luogo nella risposta in base alla località di origine del percorso specificata nella richiesta. Quando specifichi l'origine del percorso, la risposta non contiene solo un elenco di luoghi che corrispondono alla ricerca, ma anche la durata e la distanza del viaggio dall'origine del percorso a ogni luogo.

Nell'immagine seguente, i punti A, B e C sono i luoghi restituiti nella risposta di ricerca:

Per ogni luogo nei risultati, la risposta contiene la durata e la distanza del viaggio dall'origine del percorso al luogo, se disponibili.

Nota:si tratta solo di una stima delle informazioni sul percorso. Per ottenere i dettagli effettivi del percorso, incluse le indicazioni stradali passo passo, utilizza l'API Routes.

Per impostazione predefinita, la durata e la distanza del viaggio vengono calcolate utilizzando l'TRAFFIC_UNAWARE opzione nell'API Routes. Facoltativamente, puoi impostare le preferenze di routing in modo che tengano conto delle condizioni del traffico in tempo reale TRAFFIC_AWARE_OPTIMAL o delle condizioni del traffico in tempo reale con latenza ridotta TRAFFIC_AWARE durante i calcoli.

Nota:TRAFFIC_AWARE e TRAFFIC_OPTIMAL si applicano solo alle modalità di viaggio DRIVE e TWO_WHEELER. Se viene specificata una preferenza di routing con una modalità di viaggio non supportata, il calcolo del riepilogo del percorso utilizza per impostazione predefinita l'opzione TRAFFIC_UNAWARE. Se TWO_WHEELER viene specificato in una regione non supportata, l'API restituisce un riepilogo del percorso vuoto.

Quando imposti la TRAFFIC_AWARE preferenza di routing, i percorsi vengono calcolati tenendo conto delle condizioni del traffico. Di conseguenza, il percorso e i relativi dettagli riflettono in modo più accurato le condizioni del mondo reale. Poiché questo aumento della qualità dei dati comporta un aumento della latenza della risposta, vengono applicate ottimizzazioni delle prestazioni per ridurre gran parte della latenza. Quando imposti la TRAFFIC_AWARE_OPTIMAL preferenza di routing, i percorsi vengono calcolati tenendo conto delle condizioni del traffico, ma non vengono applicate ottimizzazioni delle prestazioni. In questa modalità, il server esegue una ricerca più esaustiva della rete stradale per trovare il percorso ottimale.

Informazioni su percorsi, tratte e waypoint

Un percorso, calcolato dall'API Routes, è composto da diversi componenti:

Un percorso è composto dai seguenti componenti:

• Waypoint: per calcolare un percorso, devi specificare almeno le località di origine e destinazione. Definisci queste località come waypoint su il percorso. I waypoint intermedi sono le località tra l'origine e la destinazione che vuoi che il percorso attraversi.

• Percorso: l'intero viaggio dal waypoint di origine, passando per eventuali waypoint intermedi, fino al waypoint di destinazione. Un percorso è composto da uno o più tratte.

  Quando passi un percorso alla Ricerca testuale, passi la polilinea codificata del percorso restituita dall'API Routes. Una polilinea codificata è un elenco codificato di punti di latitudine e longitudine che ti consente di rappresentare la polilinea del percorso come una stringa.

• Tratta: il percorso da un waypoint di un percorso al waypoint successivo del percorso. Ogni tratta è composta da uno o più passaggi discreti.

  Un percorso contiene una tratta separata per il percorso da ogni waypoint al successivo. Ad esempio, se il percorso contiene un singolo waypoint di origine e un singolo waypoint di destinazione, il percorso contiene una singola tratta.

  Per ogni waypoint aggiuntivo che aggiungi al percorso dopo l'origine e la destinazione, chiamato waypoint intermedio, l'API aggiunge una tratta separata.

Per ulteriori informazioni sui percorsi e sul calcolo dei percorsi, consulta l'API Routes.

Calcolare il riepilogo del percorso con una ricerca lungo il percorso

Puoi combinare i calcoli del riepilogo del percorso con la ricerca lungo un percorso. In questo caso, Ricerca testuale (New) restituisce la durata del viaggio e la distanza per ogni luogo nella risposta e poi da ogni luogo alla destinazione finale del percorso. Considera questo calcolo come la fornitura di una durata e una distanza del viaggio se devii dal percorso specificato per raggiungere un luogo nei risultati di ricerca e poi continui fino alla destinazione finale.

Ad esempio, considera il seguente percorso dall'origine alla destinazione calcolato dall'API Routes. Passa questo percorso all'API Ricerca testuale (New) insieme ai criteri di ricerca.

In questo esempio, la località A è un luogo restituito nei risultati di ricerca da Ricerca testuale (New). Per ogni luogo nella risposta, la ricerca include la durata e la distanza necessarie per deviare verso quel luogo come un viaggio di due tratte:

• La prima tratta contiene la durata e la distanza del viaggio dall' origine del percorso al luogo. In questo esempio, dall'origine al luogo A.
• La seconda tratta contiene la durata e la distanza del viaggio dal luogo alla destinazione del percorso. In questo esempio, da A alla destinazione.

Dalle informazioni nella risposta, puoi quindi calcolare la durata e la distanza della deviazione, dove:

• \(t_{OD}\) è la durata del viaggio dall'origine alla destinazione, \(s_{OD}\) è la distanza del viaggio dall'origine alla destinazione
• \(t_{OA}\) è la durata del viaggio dall'origine ad A; \(s_{OA}\) è la distanza del viaggio dall'origine ad A
• \(t_{AD}\) è la durata del viaggio da A alla destinazione; \(s_{AD}\) è la distanza del viaggio da A alla destinazione

La durata della deviazione è la differenza di durata tra il viaggio originale (dall'origine alla destinazione) e il nuovo viaggio (dall'origine alla destinazione passando per A):

$$ t_{detour} = t_{OA} + t_{AD} - t_{OD} $$

La distanza della deviazione è la differenza di distanza tra il viaggio originale (dall'origine alla destinazione) e il nuovo viaggio (dall'origine alla destinazione passando per A):

$$ s_{detour} = s_{OA} + s_{AD} - s_{OD} $$