Condividi tramite


RouteURL class

Un valore RouteURL rappresenta un URL per le operazioni di route Mappe di Azure.

Extends

Costruttori

RouteURL(Pipeline, string)

Crea un'istanza di RouteURL.

Proprietà ereditate

mapsUrl

Valore stringa URL di base.

Metodi

calculateRouteDirections(Aborter, GeoJSON.Position[], CalculateRouteDirectionsOptions)

Restituisce una route tra un'origine e una destinazione, passando attraverso i punti di direzione, se specificati. Il percorso prenderà in considerazione fattori quali il traffico corrente e le velocità tipiche della strada nel giorno richiesto della settimana e dell'ora del giorno. Le informazioni restituite includono la distanza, il tempo di viaggio stimato e una rappresentazione della geometria del percorso. Sono disponibili anche informazioni aggiuntive sul routing, ad esempio l'ordine dei punti di recapito ottimizzato o turni per turno, a seconda delle opzioni selezionate.

Il servizio di routing fornisce un set di parametri per una descrizione dettagliata del modello di consumo specifico del veicolo. Per una spiegazione dettagliata dei concetti e dei parametri coinvolti, vedere Modello a consumo .

Se options.postBody viene specificato, usa l'API Post Route Directions: https://docs.microsoft.com/rest/api/maps/route/postroutedirections

In caso contrario, usa l'API Get Route Directions: https://docs.microsoft.com/rest/api/maps/route/getroutedirections

calculateRouteMatrix(Aborter, CalculateRouteMatrixRequestBody, CalculateRouteMatrixOptions)

Nota: questa API è attualmente in anteprima e può essere soggetta a modifiche di rilievo. Calcola una matrice di riepiloghi di route per un set di route definite dalle posizioni di origine e di destinazione. Per ogni origine specificata, questo servizio calcola il costo del routing da tale origine a ogni destinazione specificata. Il set di origini e il set di destinazioni possono essere considerati come le intestazioni di colonna e di riga di una tabella e ogni cella della tabella contiene i costi di routing dall'origine alla destinazione per tale cella. Per ogni itinerario vengono calcolati i tempi di viaggio e le distanze. È possibile usare i costi calcolati per determinare le route da calcolare usando l'API Indicazioni stradali di routing. Se il parametro waitForResults nella richiesta è impostato su false (valore predefinito), questa API restituisce un codice di risposta 202 lungo un URL di reindirizzamento nel campo Percorso dell'intestazione della risposta. Questo URL deve essere controllato periodicamente fino a quando non sono disponibili i dati di risposta o le informazioni sull'errore. La dimensione massima di una matrice per questa API è 700 (il numero di origini moltiplicato per il numero di destinazioni). Tenendo presente questo vincolo, esempi di possibili dimensioni della matrice sono: 50x10, 10x10, 28x25. 10x70 (non deve essere quadrato).

Il calcolo di una matrice di route è considerato un'operazione a esecuzione prolungata. Le operazioni a esecuzione prolungata implicano che dopo l'accettazione della richiesta iniziale (HTTP 202) il risultato finale verrà sottoposto a polling fino a quando non sarà disponibile. Ogni richiesta di polling riavvia il timeout dell'interruzione, se ne è stato specificato uno.

Usa l'API Post Route Matrix: https://docs.microsoft.com/rest/api/maps/route/postroutematrixpreview

calculateRouteRange(Aborter, GeoJSON.Position, CalculateRouteRangeOptions)

Calcolare un set di posizioni che possono essere raggiunte dal punto di origine in base a carburante, energia o budget di tempo specificato. Un limite poligono (o Isocrona) viene restituito in un orientamento antiorario, nonché il centro poligono preciso che era il risultato del punto di origine. Il poligono restituito può essere usato per un'ulteriore elaborazione, ad esempio Search Inside Geometry per cercare poi all'interno dell'isocrona specificata.

Usa l'API Get Route Range: https://docs.microsoft.com/rest/api/maps/route/getrouterange

Metodi ereditati

newPipeline(Credential, INewPipelineOptions)

Metodo statico usato per creare un nuovo oggetto Pipeline con credenziali fornite.

Dettagli costruttore

RouteURL(Pipeline, string)

Crea un'istanza di RouteURL.

new RouteURL(pipeline: Pipeline, mapsUrl?: string)

Parametri

pipeline
Pipeline

Chiamare MapsURL.newPipeline() per creare una pipeline predefinita o fornire una pipeline personalizzata.

mapsUrl

string

Una stringa URL che punta a Mappe di Azure servizio, il valore predefinito è "https://atlas.microsoft.com". Se non viene specificato alcun protocollo, ad esempio "atlas.microsoft.com", https verrà assunto.

Dettagli proprietà ereditate

mapsUrl

Valore stringa URL di base.

mapsUrl: string

Valore della proprietà

string

Ereditato daMapsURL.mapsUrl

Dettagli metodo

calculateRouteDirections(Aborter, GeoJSON.Position[], CalculateRouteDirectionsOptions)

Restituisce una route tra un'origine e una destinazione, passando attraverso i punti di direzione, se specificati. Il percorso prenderà in considerazione fattori quali il traffico corrente e le velocità tipiche della strada nel giorno richiesto della settimana e dell'ora del giorno. Le informazioni restituite includono la distanza, il tempo di viaggio stimato e una rappresentazione della geometria del percorso. Sono disponibili anche informazioni aggiuntive sul routing, ad esempio l'ordine dei punti di recapito ottimizzato o turni per turno, a seconda delle opzioni selezionate.

Il servizio di routing fornisce un set di parametri per una descrizione dettagliata del modello di consumo specifico del veicolo. Per una spiegazione dettagliata dei concetti e dei parametri coinvolti, vedere Modello a consumo .

Se options.postBody viene specificato, usa l'API Post Route Directions: https://docs.microsoft.com/rest/api/maps/route/postroutedirections

In caso contrario, usa l'API Get Route Directions: https://docs.microsoft.com/rest/api/maps/route/getroutedirections

function calculateRouteDirections(aborter: Aborter, coordinates: GeoJSON.Position[], options?: CalculateRouteDirectionsOptions): Promise<CalculateRouteDirectionsResponse>

Parametri

aborter
Aborter

Creare una nuova istanza di Aborter con Aborter.none o Aborter.timeout(), documenti goto di Aborter per altri esempi sull'annullamento della richiesta.

coordinates

GeoJSON.Position[]

Matrice di coordinate attraverso la quale viene calcolata la route. Ogni coordinata è una matrice di [longitude, latitude]. Sono necessarie almeno due coordinate. Il primo è l'origine e l'ultimo è la destinazione della route. Le coordinate facoltative in-between fungono da WayPoints nella route. È possibile passare fino a 150 WayPoint.

Restituisce

calculateRouteMatrix(Aborter, CalculateRouteMatrixRequestBody, CalculateRouteMatrixOptions)

Nota: questa API è attualmente in anteprima e può essere soggetta a modifiche di rilievo. Calcola una matrice di riepiloghi di route per un set di route definite dalle posizioni di origine e di destinazione. Per ogni origine specificata, questo servizio calcola il costo del routing da tale origine a ogni destinazione specificata. Il set di origini e il set di destinazioni possono essere considerati come le intestazioni di colonna e di riga di una tabella e ogni cella della tabella contiene i costi di routing dall'origine alla destinazione per tale cella. Per ogni itinerario vengono calcolati i tempi di viaggio e le distanze. È possibile usare i costi calcolati per determinare le route da calcolare usando l'API Indicazioni stradali di routing. Se il parametro waitForResults nella richiesta è impostato su false (valore predefinito), questa API restituisce un codice di risposta 202 lungo un URL di reindirizzamento nel campo Percorso dell'intestazione della risposta. Questo URL deve essere controllato periodicamente fino a quando non sono disponibili i dati di risposta o le informazioni sull'errore. La dimensione massima di una matrice per questa API è 700 (il numero di origini moltiplicato per il numero di destinazioni). Tenendo presente questo vincolo, esempi di possibili dimensioni della matrice sono: 50x10, 10x10, 28x25. 10x70 (non deve essere quadrato).

Il calcolo di una matrice di route è considerato un'operazione a esecuzione prolungata. Le operazioni a esecuzione prolungata implicano che dopo l'accettazione della richiesta iniziale (HTTP 202) il risultato finale verrà sottoposto a polling fino a quando non sarà disponibile. Ogni richiesta di polling riavvia il timeout dell'interruzione, se ne è stato specificato uno.

Usa l'API Post Route Matrix: https://docs.microsoft.com/rest/api/maps/route/postroutematrixpreview

function calculateRouteMatrix(aborter: Aborter, body: CalculateRouteMatrixRequestBody, options?: CalculateRouteMatrixOptions): Promise<CalculateRouteMatrixResponse>

Parametri

aborter
Aborter

Creare una nuova istanza di Aborter con Aborter.none o Aborter.timeout(), documenti goto di Aborter per altri esempi sull'annullamento della richiesta.

body
CalculateRouteMatrixRequestBody

Matrice delle coordinate di origine e di destinazione per calcolare la distanza di route, il tempo di viaggio e altro riepilogo per ogni cella della matrice in base ai parametri di input. Il numero minimo e il numero massimo di celle supportati sono rispettivamente 1 e 700. Ad esempio, può essere di 35 origini e 20 destinazioni o 25 origini e 25 destinazioni.

Restituisce

calculateRouteRange(Aborter, GeoJSON.Position, CalculateRouteRangeOptions)

Calcolare un set di posizioni che possono essere raggiunte dal punto di origine in base a carburante, energia o budget di tempo specificato. Un limite poligono (o Isocrona) viene restituito in un orientamento antiorario, nonché il centro poligono preciso che era il risultato del punto di origine. Il poligono restituito può essere usato per un'ulteriore elaborazione, ad esempio Search Inside Geometry per cercare poi all'interno dell'isocrona specificata.

Usa l'API Get Route Range: https://docs.microsoft.com/rest/api/maps/route/getrouterange

function calculateRouteRange(aborter: Aborter, center: GeoJSON.Position, options?: CalculateRouteRangeOptions): Promise<CalculateRouteRangeResponse>

Parametri

aborter
Aborter

Creare una nuova istanza di Aborter con Aborter.none o Aborter.timeout(), documenti goto di Aborter per altri esempi sull'annullamento della richiesta.

center
GeoJSON.Position

Coordinata da cui deve iniziare il calcolo dell'intervallo.

Restituisce

Dettagli dei metodi ereditati

newPipeline(Credential, INewPipelineOptions)

Metodo statico usato per creare un nuovo oggetto Pipeline con credenziali fornite.

static function newPipeline(credential: Credential, pipelineOptions?: INewPipelineOptions): Pipeline

Parametri

credential
Credential

Ad esempio SubscriptionKeyCredential, TokenCredential e MapControlCredential.

pipelineOptions
INewPipelineOptions

Restituisce

Nuovo oggetto Pipeline.

Ereditato daMapsURL.newPipeline