Panoramica della ricerca lungo il percorso

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

• Solo ricerca di testo (novità):cerca luoghi lungo un percorso predefinito della corsa.
• Ricerca di testo (novità) e Ricerca nelle vicinanze (novità): calcola il riepilogo del percorso da una località di partenza del percorso specificata a ogni luogo nei risultati di ricerca.
• Solo ricerca di testo (nuova):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 del viaggio tra due località. L'API Routes può calcolare un itinerario per auto, bicicletta, veicolo a due ruote, sistema di trasporto pubblico o a piedi.

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

La ricerca di testo (novità) 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 di testo (nuova). La risposta contiene quindi i luoghi che corrispondono ai criteri di ricerca e 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 dell'area visibile, mentre locationBias potrebbe restituire risultati di ricerca esterni all'area visibile. Tuttavia, mentre le opzioni locationBias e locationRestriction ti consentono di specificare una regione per spostare in modo ingannevole i risultati di ricerca, la funzionalità di ricerca lungo il percorso nella ricerca di testo consente anche di spostare in modo ingannevole i risultati di ricerca in modo da includere quelli con tempi di deviazione minimi dall'origine al destinazione del percorso. Puoi influenzare i risultati di ricerca utilizzando locationBias o locationRestriction in combinazione con il polilinea.

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

Quando esegui una ricerca lungo il percorso, la ricerca è orientata a restituire 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 calcolo del percorso

La ricerca di testo (novità) e la 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 partenza del percorso specificata nella richiesta. Quando specifichi l'origine del percorso, la risposta non contiene solo un elenco di luoghi corrispondenti 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 alla ricerca:

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

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'opzione TRAFFIC_UNAWARE nell'API Routes. Se vuoi, puoi impostare le preferenze di routing in modo che vengano prese in considerazione le condizioni di traffico in tempo reale TRAFFIC_AWARE_OPTIMAL o le condizioni di 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 una delle preferenze di routing viene 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 TRAFFIC_AWARE preferenza di itinerario, i percorsi vengono calcolati tenendo conto delle condizioni del traffico. Di conseguenza, il percorso e i relativi dettagli riflettono con maggiore precisione le condizioni reali. Poiché questo aumento della qualità dei dati avviene a scapito della latenza di risposta, vengono applicate ottimizzazioni del rendimento 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ù completa della rete stradale per trovare il percorso ottimale.

Informazioni su percorsi, tratti e waypoint

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

Un percorso è costituito dai seguenti componenti:

• Waypoint: per calcolare un percorso, specifica almeno le posizioni di partenza e destinazione. Definisci queste posizioni come waypoint sul percorso. Le tappe intermedie sono le posizioni tra l'origine e la destinazione che vuoi che il percorso attraversi.

• Percorso: l'intero viaggio dal waypoint di partenza, attraverso eventuali waypoint intermedi, al waypoint di destinazione. Un itinerario è costituito da uno o più tratte.

  Quando passi un itinerario alla ricerca di testo, devi passare la polilinea codificata dell'itinerario 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 stringa.

• Tappa: il percorso da un waypoint in un percorso al waypoint successivo nel percorso. Ogni tratto è costituito da uno o più passaggi distinti.

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

  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 sulle route e sul calcolo delle route, consulta l'API Route.

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, la ricerca di testo (nuova) restituisce la durata del viaggio e la distanza da ogni luogo nella risposta, quindi da ogni luogo alla destinazione finale del percorso. Considera questo calcolo come un modo per fornire la durata e la distanza del viaggio se fai un giro dal percorso specificato per raggiungere un luogo nei risultati di ricerca e poi prosegui 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 della ricerca di testo (nuova). Per ogni luogo nella risposta, la ricerca include la durata e la distanza necessarie per fare un percorso in due tappe:

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

Dalle informazioni nella risposta, puoi calcolare la durata e la distanza del tragitto alternativo, 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 del 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 del percorso alternativo è la differenza di distanza tra il percorso originale (dall'origine alla destinazione) e il nuovo percorso (dall'origine alla destinazione tramite A):

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