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
maps |
Valore stringa URL di base. |
Metodi
calculate |
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 In caso contrario, usa l'API Get Route Directions: https://docs.microsoft.com/rest/api/maps/route/getroutedirections |
calculate |
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 |
calculate |
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
new |
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.
- options
- CalculateRouteDirectionsOptions
Restituisce
Promise<CalculateRouteDirectionsResponse>
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.
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.
- options
- CalculateRouteMatrixOptions
Restituisce
Promise<CalculateRouteMatrixResponse>
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.
- options
- CalculateRouteRangeOptions
Restituisce
Promise<CalculateRouteRangeResponse>
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