RouteURL class

Uma RouteURL representa uma URL para as operações de rota Azure Mapas.

Extends

Construtores

RouteURL(Pipeline, string)

Cria uma instância de RouteURL.

Propriedades herdadas

mapsUrl

Valor da cadeia de caracteres da URL base.

Métodos

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

Retorna uma rota entre uma origem e um destino, passando por pontos de passagem se eles forem especificados. A rota levará em conta fatores como o tráfego atual e as velocidades típicas da estrada no dia solicitado da semana e hora do dia. As informações retornadas incluem a distância, o tempo estimado de viagem e uma representação da geometria da rota. Informações adicionais de roteamento, como ordem otimizada do ponto de passagem ou instruções por turno, também estão disponíveis, dependendo das opções selecionadas.

O serviço de roteamento fornece um conjunto de parâmetros para uma descrição detalhada do Modelo de Consumo específico do veículo. Marcar Modelo de Consumo para obter uma explicação detalhada dos conceitos e parâmetros envolvidos.

Se options.postBody for especificado, usará a API de Direções pós-rota: https://docs.microsoft.com/rest/api/maps/route/postroutedirections

Caso contrário, usa a API Obter Trajetos de Rota: https://docs.microsoft.com/rest/api/maps/route/getroutedirections

calculateRouteMatrix(Aborter, CalculateRouteMatrixRequestBody, CalculateRouteMatrixOptions)

Observação: essa API está atualmente em versão prévia e pode estar sujeita a alterações interruptivas. Calcula uma matriz de resumos de rota para um conjunto de rotas definidas por locais de origem e destino. Para cada origem determinada, esse serviço calcula o custo de roteamento dessa origem para cada destino determinado. O conjunto de origens e o conjunto de destinos podem ser considerados como cabeçalhos de coluna e linha de uma tabela e cada célula na tabela contém os custos de roteamento da origem para o destino dessa célula. Para cada rota, os tempos de viagem e as distâncias são calculados. Você pode usar os custos calculados para determinar quais rotas calcular usando a API de Direções de Roteamento. Se o parâmetro waitForResults na solicitação estiver definido como false (valor padrão), essa API retornará um código de resposta 202 ao longo de uma URL de redirecionamento no campo Local do cabeçalho de resposta. Essa URL deve ser verificada periodicamente até que os dados de resposta ou as informações de erro estejam disponíveis. O tamanho máximo de uma matriz para essa API é 700 (o número de origens multiplicado pelo número de destinos). Com essa restrição em mente, exemplos de possíveis dimensões de matriz são: 50x10, 10x10, 28x25. 10x70 (não precisa ser quadrado).

O cálculo de uma matriz de rotas é considerado uma operação de execução prolongada. Uma operação de execução prolongada implica que, depois que a solicitação inicial for aceita (HTTP 202), o resultado final será sondado até que esteja disponível. Cada solicitação de sondagem reiniciará o tempo limite do anulador, se um tiver sido especificado.

Usa a API de Matriz pós-rota: https://docs.microsoft.com/rest/api/maps/route/postroutematrixpreview

calculateRouteRange(Aborter, GeoJSON.Position, CalculateRouteRangeOptions)

Calcule um conjunto de locais que podem ser alcançados do ponto de origem com base no combustível, energia ou orçamento de tempo especificado. Um limite de polígono (ou Isócrono) é retornado em uma orientação anti-horário, bem como no centro de polígono preciso que foi o resultado do ponto de origem. O polígono retornado pode ser usado para processamento adicional, como Pesquisa Dentro da Geometria para pesquisar POIs dentro do Isócrono fornecido.

Usa a API Obter Intervalo de Rotas: https://docs.microsoft.com/rest/api/maps/route/getrouterange

Métodos herdados

newPipeline(Credential, INewPipelineOptions)

Um método estático usado para criar um novo objeto Pipeline com Credential fornecido.

Detalhes do construtor

RouteURL(Pipeline, string)

Cria uma instância de RouteURL.

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

Parâmetros

pipeline
Pipeline

Chame MapsURL.newPipeline() para criar um pipeline padrão ou forneça um pipeline personalizado.

mapsUrl

string

Uma cadeia de caracteres de URL que aponta para Azure Mapas serviço, o padrão é "https://atlas.microsoft.com". Se nenhum protocolo for especificado, por exemplo "atlas.microsoft.com", , https será assumido.

Detalhes das propriedades herdadas

mapsUrl

Valor da cadeia de caracteres da URL base.

mapsUrl: string

Valor da propriedade

string

Herdado deMapsURL.mapsUrl

Detalhes do método

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

Retorna uma rota entre uma origem e um destino, passando por pontos de passagem se eles forem especificados. A rota levará em conta fatores como o tráfego atual e as velocidades típicas da estrada no dia solicitado da semana e hora do dia. As informações retornadas incluem a distância, o tempo estimado de viagem e uma representação da geometria da rota. Informações adicionais de roteamento, como ordem otimizada do ponto de passagem ou instruções por turno, também estão disponíveis, dependendo das opções selecionadas.

O serviço de roteamento fornece um conjunto de parâmetros para uma descrição detalhada do Modelo de Consumo específico do veículo. Marcar Modelo de Consumo para obter uma explicação detalhada dos conceitos e parâmetros envolvidos.

Se options.postBody for especificado, usará a API de Direções pós-rota: https://docs.microsoft.com/rest/api/maps/route/postroutedirections

Caso contrário, usa a API Obter Trajetos de Rota: https://docs.microsoft.com/rest/api/maps/route/getroutedirections

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

Parâmetros

aborter
Aborter

Crie uma nova instância do Aborter com Aborter.none ou Aborter.timeout(), documentos goto do Aborter para obter mais exemplos sobre cancelamento de solicitação.

coordinates

GeoJSON.Position[]

Uma matriz de coordenadas por meio da qual a rota é calculada. Cada coordenada é uma matriz de [longitude, latitude]. Um mínimo de duas coordenadas é necessário. A primeira é a origem e a última é o destino da rota. As coordenadas opcionais no meio atuam como WayPoints na rota. Você pode passar até 150 WayPoints.

Retornos

calculateRouteMatrix(Aborter, CalculateRouteMatrixRequestBody, CalculateRouteMatrixOptions)

Observação: essa API está atualmente em versão prévia e pode estar sujeita a alterações interruptivas. Calcula uma matriz de resumos de rota para um conjunto de rotas definidas por locais de origem e destino. Para cada origem determinada, esse serviço calcula o custo de roteamento dessa origem para cada destino determinado. O conjunto de origens e o conjunto de destinos podem ser considerados como cabeçalhos de coluna e linha de uma tabela e cada célula na tabela contém os custos de roteamento da origem para o destino dessa célula. Para cada rota, os tempos de viagem e as distâncias são calculados. Você pode usar os custos calculados para determinar quais rotas calcular usando a API de Direções de Roteamento. Se o parâmetro waitForResults na solicitação estiver definido como false (valor padrão), essa API retornará um código de resposta 202 ao longo de uma URL de redirecionamento no campo Local do cabeçalho de resposta. Essa URL deve ser verificada periodicamente até que os dados de resposta ou as informações de erro estejam disponíveis. O tamanho máximo de uma matriz para essa API é 700 (o número de origens multiplicado pelo número de destinos). Com essa restrição em mente, exemplos de possíveis dimensões de matriz são: 50x10, 10x10, 28x25. 10x70 (não precisa ser quadrado).

O cálculo de uma matriz de rotas é considerado uma operação de execução prolongada. Uma operação de execução prolongada implica que, depois que a solicitação inicial for aceita (HTTP 202), o resultado final será sondado até que esteja disponível. Cada solicitação de sondagem reiniciará o tempo limite do anulador, se um tiver sido especificado.

Usa a API de Matriz pós-rota: https://docs.microsoft.com/rest/api/maps/route/postroutematrixpreview

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

Parâmetros

aborter
Aborter

Crie uma nova instância do Aborter com Aborter.none ou Aborter.timeout(), documentos goto do Aborter para obter mais exemplos sobre cancelamento de solicitação.

body
CalculateRouteMatrixRequestBody

A matriz de coordenadas de origem e destino para calcular a distância da rota, o tempo de viagem e outros resumos para cada célula da matriz com base nos parâmetros de entrada. O mínimo e a contagem máxima de células com suporte são 1 e 700, respectivamente. Por exemplo, pode ser 35 origens e 20 destinos ou 25 origens e 25 destinos.

Retornos

calculateRouteRange(Aborter, GeoJSON.Position, CalculateRouteRangeOptions)

Calcule um conjunto de locais que podem ser alcançados do ponto de origem com base no combustível, energia ou orçamento de tempo especificado. Um limite de polígono (ou Isócrono) é retornado em uma orientação anti-horário, bem como no centro de polígono preciso que foi o resultado do ponto de origem. O polígono retornado pode ser usado para processamento adicional, como Pesquisa Dentro da Geometria para pesquisar POIs dentro do Isócrono fornecido.

Usa a API Obter Intervalo de Rotas: https://docs.microsoft.com/rest/api/maps/route/getrouterange

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

Parâmetros

aborter
Aborter

Crie uma nova instância do Aborter com Aborter.none ou Aborter.timeout(), documentos goto do Aborter para obter mais exemplos sobre cancelamento de solicitação.

center
GeoJSON.Position

A coordenada da qual o cálculo do intervalo deve ser iniciado.

Retornos

Detalhes do método herdado

newPipeline(Credential, INewPipelineOptions)

Um método estático usado para criar um novo objeto Pipeline com Credential fornecido.

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

Parâmetros

credential
Credential

Como SubscriptionKeyCredential, TokenCredential e MapControlCredential.

pipelineOptions
INewPipelineOptions

Retornos

Um novo objeto Pipeline.

Herdado deMapsURL.newPipeline