Panoramica della ricerca lungo il percorso

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

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

Cerca lungo un percorso

Utilizza l'API Routes per calcolare il percorso del tragitto 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 a piedi.

Ricerca testuale (Nuovo) 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 (novità). 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 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 influenzare i risultati di ricerca, la funzionalità di ricerca lungo il percorso in Ricerca testuale ti consente anche di influenzare i risultati di ricerca in modo da includere quelli con tempi di deviazione minimi dall'origine 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, indicato come waypoint nell'API Routes, alla destinazione calcolata dall'API Routes:

Percorso dal waypoint di partenza alla destinazione con i risultati di ricerca.

Quando esegui una ricerca lungo il percorso, la ricerca è orientata 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 i luoghi restituiti dalla ricerca.

Calcola il riepilogo del routing

Ricerca testuale (novità) e Nearby Search (novità) 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 ciascun luogo.

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

I punti A, B e C sono i 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 disponibile.

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 da prendere in considerazione le condizioni del traffico in tempo reale TRAFFIC_AWARE_OPTIMAL o le condizioni del traffico in tempo reale con latenza ridotta TRAFFIC_AWARE durante i calcoli.

Informazioni su percorsi, tappe e waypoint

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

I componenti che costituiscono un percorso.

Un percorso è costituito dai seguenti componenti:

  • Waypoint: per calcolare un percorso, devi specificare almeno le località di partenza e di arrivo. Queste località vengono definite come waypoint sul percorso. I punti di passaggio intermedi sono località tra l'origine e la destinazione che vuoi che il percorso attraversi.

  • Percorso: l'intero tragitto dal waypoint di partenza, attraverso eventuali waypoint intermedi, fino al waypoint di destinazione. Un percorso è composto da una o più tappe.

    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 consente di rappresentare la polilinea del percorso come stringa.

  • Tratto: il percorso da un waypoint di un itinerario al waypoint successivo. Ogni tratto è composto da uno o più passaggi discreti.

    Un percorso contiene una tappa separata per il tragitto 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 un singolo tratto.

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

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

Calcola 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 la distanza da ogni luogo nella risposta, quindi da ogni luogo alla destinazione finale del percorso. Questo calcolo fornisce la durata e la distanza del viaggio se devii 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 Ricerca testuale (New) insieme ai criteri di ricerca.

Percorso dal waypoint di partenza alla destinazione con deviazione al risultato di ricerca.

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

  • La prima tappa contiene la durata e la distanza del viaggio dal luogo di partenza 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.

In base alle informazioni contenute nella risposta, puoi calcolare la durata e la distanza della deviazione, dove:

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

La durata della deviazione è la differenza di durata tra il percorso originale (dal punto di partenza alla destinazione) e il nuovo percorso (dal punto di partenza alla destinazione passando per A):

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

La distanza della deviazione è la differenza di distanza tra il percorso originale (dal punto di partenza alla destinazione) e il nuovo percorso (dal punto di partenza alla destinazione passando per A):

$$ s_{detour} = s_{OA} + s_{AD} - s_{OD} $$
Avanti
Cerca lungo il percorso