Panoramica della ricerca lungo il percorso

Gli elementi di Ricerca lungo il percorso sono disponibili nelle seguenti API (nuove) di Places:

• Solo ricerca testuale (novità): cerca luoghi lungo un percorso predefinito. percorso.
• 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 testuale (nuova):calcola il riepilogo dei percorsi 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 Text Search (New). 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 al di fuori dell'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 Ad esempio, i punti A, B e C sono 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 di routing, la risposta non contiene solo un elenco di luoghi che corrispondono alla ricerca, ma anche durata del viaggio e distanza dall'origine di routing a ogni luogo.

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

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 il valore i dettagli del percorso, incluse le indicazioni stradali dettagliate, utilizza la scheda Percorsi di terze parti.

Per impostazione predefinita, la durata del viaggio e la distanza vengono calcolate utilizzando la TRAFFIC_UNAWARE nell'API Routes. Facoltativamente, puoi impostare preferenze di routing condizioni del traffico in tempo reale TRAFFIC_AWARE_OPTIMAL o con condizioni di traffico in tempo reale ridotte dalla latenza TRAFFIC_AWARE durante i calcoli.

Nota: TRAFFIC_AWARE e TRAFFIC_OPTIMAL si applicano solo a le modalità di viaggio DRIVE e TWO_WHEELER. Se una delle preferenze di routing è specificato con una modalità di viaggio non supportata, per impostazione predefinita il calcolo del riepilogo dei percorsi utilizza i Opzione TRAFFIC_UNAWARE. Se TWO_WHEELER viene specificato in un una regione non supportata, l'API restituisce un il riepilogo del routing è vuoto.

Quando imposti la TRAFFIC_AWARE preferenza di itinerario, i percorsi vengono calcolati tenendo conto delle condizioni del traffico. Come risultato, il percorso e i dettagli del percorso riflettono più accuratamente il mondo reale le condizioni di traffico. Poiché questo aumento della qualità dei dati avviene a scapito della latenza di 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ù completa della rete stradale per trovare il percorso ottimale.

Informazioni su percorsi, tappe e tappe

Diversi componenti compongono una route, calcolata 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 percorso è composto da o più gambe.

  Quando passi un itinerario alla ricerca di testo, devi passare la polilinea codificata dell'itinerario restituita dall'API Routes. Un codice la polilinea è un elenco codificato di punti di latitudine e longitudine che consente di rappresentare i la polilinea della route come stringa.

• Tappa: il percorso da un waypoint in un percorso al waypoint successivo nel percorso. Ogni gamba è costituita da uno o più passi discreti.

  Un itinerario contiene un tratto separato per il percorso da ogni waypoint al successivo. Ad esempio, se il percorso contiene un solo waypoint di origine e un singolo tappa di destinazione, il percorso contiene un solo 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, Ricerca testuale (Nuova) restituisce la durata del viaggio e distanza da ogni luogo nella risposta, quindi da ogni luogo destinazione 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 verso la 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 punto della risposta, la ricerca include la durata e la distanza necessaria per effettuare una deviazione verso quel luogo come corsa in due tratti:

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

Dalle informazioni nella risposta puoi calcolare la deviazione durata e distanza, 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 della corsa 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} $$

Distanza deviazione è la differenza di distanza tra la corsa originale (dall'origine alla destinazione) e il nuovo viaggio (dall'origine a dalla destinazione attraverso A):

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