Panoramica della ricerca lungo il percorso

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

• Solo ricerca di testo (nuova):cerca luoghi lungo un percorso di viaggio predefinito.
• Ricerca di testo (nuova) e Ricerca nelle vicinanze (nuova): calcola il riepilogo del percorso da una posizione di origine specificata a ogni luogo nei risultati di ricerca.
• Solo ricerca di testo (nuova):calcola il riepilogo dell'itinerario per ogni luogo lungo un percorso di viaggio predefinito.

Cercare lungo un percorso

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

Nota: le tratte del sistema di trasporto pubblico non sono supportate dall'API Places.

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

La ricerca lungo un percorso è simile all'utilizzo delle opzioni di richiesta locationRestriction o locationBias per orientare i risultati di ricerca. locationRestriction restituisce risultati di ricerca che rientrano nei limiti dell'area visibile, mentre locationBias potrebbe restituire risultati di ricerca al di fuori dell'area visibile. Tuttavia, mentre le opzioni locationBias e locationRestriction ti consentono di specificare una regione per orientare i risultati di ricerca, la funzionalità di ricerca lungo il percorso in Text Search ti consente anche di orientare i risultati di ricerca in modo da includere quelli con tempi di deviazione minimi dall'origine dell'itinerario alla destinazione dell'itinerario. Puoi distorcere i risultati di ricerca utilizzando locationBias o locationRestriction in combinazione con la polilinea.

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

Quando esegui una ricerca lungo il percorso, i risultati della ricerca sono orientati a restituire luoghi vicini al percorso con tempi di deviazione minimi dall'origine alla destinazione. In questo esempio, i punti A, B e C sono luoghi restituiti dalla ricerca.

Calcolare il riepilogo del routing

Ricerca di testo (novità) e Ricerca nelle vicinanze (novità) possono calcolare il riepilogo del percorso, ovvero la durata e la distanza, per ogni luogo nella risposta in base alla posizione 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 luoghi restituiti nella risposta della ricerca:

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

Nota: si tratta solo di una stima delle informazioni di routing. Per ottenere i dettagli dell'itinerario effettivo, incluse le indicazioni passo passo, utilizza l'API Routes.

Per impostazione predefinita, la durata e la distanza del viaggio vengono calcolate utilizzando l'opzione TRAFFIC_UNAWARE nell'API Routes. Puoi impostare facoltativamente 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 a latenza ridotta TRAFFIC_AWARE durante i calcoli.

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

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

Informazioni su itinerari, tappe e punti di passaggio

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

Un percorso è costituito dai seguenti componenti:

• Waypoint: per calcolare un percorso, devi specificare almeno le posizioni del punto di partenza e della destinazione. Definisci queste posizioni come waypoint sul percorso. Le tappe intermedie sono località tra l'origine e la destinazione che vuoi che l'itinerario attraversi.

• Percorso: l'intero viaggio dal waypoint di partenza, passando per eventuali waypoint intermedi, fino al waypoint di destinazione. Un itinerario è composto da una o più tappe.

  Quando passi un percorso alla ricerca di testo, 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 itinerario al waypoint successivo dell'itinerario. Ogni tratta è costituita da uno o più passaggi discreti.

  Un itinerario contiene un tratto separato per il percorso da ogni waypoint al successivo. Ad esempio, se l'itinerario contiene un singolo waypoint di partenza e un singolo waypoint di destinazione, allora l'itinerario contiene un singolo segmento.

  Per ogni waypoint aggiuntivo che aggiungi all'itinerario dopo l'origine e la destinazione, chiamato waypoint intermedio, l'API aggiunge un segmento separato.

Per saperne di più sulle route e sul loro calcolo, consulta l'API Routes.

Calcolare il riepilogo dell'itinerario con una ricerca lungo il percorso

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

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

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

• La prima tratta contiene la durata e la distanza del viaggio dall'origine dell'itinerario al luogo. In questo esempio, dall'origine al luogo A.
• Il secondo segmento contiene la durata e la distanza del viaggio dal luogo alla destinazione dell'itinerario. In questo esempio, da A alla destinazione.

Dalle informazioni contenute nella risposta, puoi 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 la corsa originale (dall'origine alla destinazione) e la nuova corsa (dall'origine alla destinazione tramite A):

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

La distanza della deviazione è la differenza di distanza tra la corsa originale (dall'origine alla destinazione) e la nuova corsa (dall'origine alla destinazione tramite A):

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