Share via

RenderURL class

  • Referência
Pacote:
azure-maps-rest

Um RenderURL representa um URL para as operações de composição de Azure Maps.

Extends
MapsURL

Construtores

RenderURL(Pipeline, string)

Cria uma instância de RenderURL.

Propriedades Herdadas

mapsUrl

Valor da cadeia de URL base.

Métodos

getMapImage(Aborter, GetMapImageOptions)

Compõe uma imagem retangular definida pelo utilizador que contém uma secção de mapa com um nível de zoom de 0 a 20. O serviço de imagem estática compõe uma imagem retangular definida pelo utilizador que contém uma secção de mapa com um nível de zoom de 0 a 20. O intervalo de resolução suportado para a imagem de mapa é de 1x1 a 8192x8192. Se estiver a decidir quando utilizar o serviço de imagens estáticas através do serviço de mosaicos de mapa, poderá considerar como pretende interagir com o mapa composto. Se o conteúdo do mapa for relativamente inalterado, um mapa estático é uma boa opção. Se quiser suportar bastante zoom, panning e alteração do conteúdo do mapa, o serviço de mosaico de mapa seria uma escolha melhor. O Serviço também fornece funcionalidades de Composição de Imagens para obter uma imagem estática de volta com dados adicionais, como; pushpins e sobreposições de geometria com as seguintes capacidades S0 e S1.

No S0, pode:

  • Compor até 5 pushpins especificados no pedido
  • Fornecer uma imagem personalizada para os pinos referenciados no pedido
  • Adicionar etiquetas aos pushpins

No S1, pode:

Veja Procedimentos do Guia para obter exemplos detalhados.

Nota : o parâmetro central ou bbox tem de ser fornecido à API.

Os intervalos Lat e Lon suportados ao utilizar o parâmetro bbox são os seguintes:

Nível de Zoom Intervalo Máximo de Lon Intervalo Máximo de Lat
0 360.0 170.0
1 360.0 170.0
2 360.0 170.0
3 360.0 170.0
4 360.0 170.0
5 180.0 85.0
6 90.0 42.5
7 45.0 21.25
8 22,5 10.625
9 11.25 5.3125
10 5.625 2.62625
11 2.8125 1.328125
12 1.40625 0.6640625
13 0.703125 0.33203125
14 0.3515625 0.166015625
15 0.17578125 0.0830078125
16 0.087890625 0.0415039063
17 0.0439453125 0.0207519531
18 0.0219726563 0.0103759766
19 0.0109863281 0.0051879883
20 0.0054931641 0.0025939941

Utiliza a API Obter Imagem de Mapa: https://docs.microsoft.com/rest/api/maps/render/getmapimage
getMapImageryTile(Aborter, number, number, number)

Devolve um mosaico de imagem de mapa com o tamanho 256x256, dadas as coordenadas x e y e o nível de zoom. O nível de zoom varia entre 0 e 18. O valor de estilo disponível atual é "satélite", que fornece apenas imagens de satélite. Utiliza a API de Mosaico Obter Imagens do Mapa: https://docs.microsoft.com/rest/api/maps/render/getmapimagerytile
getMapTile(Aborter, TileFormat, MapTileLayer, MapTileStyle, number, number, number, GetMapTileOptions)

Devolve um mosaico de mapa no formato vetor ou raster normalmente para ser integrado num novo controlo de mapa ou SDK. Por predefinição, o Azure utiliza mosaicos de mapa de vetores para o respetivo controlo de mapa Web (veja Níveis de Zoom e Grelha de Mosaicos) Utiliza a API Obter Mosaico de Mapa: https://docs.microsoft.com/rest/api/maps/render/getmaptile

Métodos Herdados

newPipeline(Credential, INewPipelineOptions)

Um método estático utilizado para criar um novo objeto pipeline com credenciais fornecidas.

Detalhes do Construtor

RenderURL(Pipeline, string)

Cria uma instância de RenderURL.

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

Parâmetros

pipeline
Pipeline

Chame MapsURL.newPipeline() para criar um pipeline predefinido ou forneça um pipeline personalizado.

mapsUrl

string

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

Detalhes da Propriedade Herdada

mapsUrl

Valor da cadeia de URL base.

mapsUrl: string

Valor de Propriedade

string

Herdado deMapsURL.mapsUrl

Detalhes de Método

getMapImage(Aborter, GetMapImageOptions)

Compõe uma imagem retangular definida pelo utilizador que contém uma secção de mapa com um nível de zoom de 0 a 20. O serviço de imagem estática compõe uma imagem retangular definida pelo utilizador que contém uma secção de mapa com um nível de zoom de 0 a 20. O intervalo de resolução suportado para a imagem de mapa é de 1x1 a 8192x8192. Se estiver a decidir quando utilizar o serviço de imagens estáticas através do serviço de mosaicos de mapa, poderá considerar como pretende interagir com o mapa composto. Se o conteúdo do mapa for relativamente inalterado, um mapa estático é uma boa opção. Se quiser suportar bastante zoom, panning e alteração do conteúdo do mapa, o serviço de mosaico de mapa seria uma escolha melhor. O Serviço também fornece funcionalidades de Composição de Imagens para obter uma imagem estática de volta com dados adicionais, como; pushpins e sobreposições de geometria com as seguintes capacidades S0 e S1.

No S0, pode:

  • Compor até 5 pushpins especificados no pedido
  • Fornecer uma imagem personalizada para os pinos referenciados no pedido
  • Adicionar etiquetas aos pushpins

No S1, pode:

Veja Procedimentos do Guia para obter exemplos detalhados.

Nota : o parâmetro central ou bbox tem de ser fornecido à API.

Os intervalos Lat e Lon suportados ao utilizar o parâmetro bbox são os seguintes:

Nível de Zoom Intervalo Máximo de Lon Intervalo Máximo de Lat
0 360.0 170.0
1 360.0 170.0
2 360.0 170.0
3 360.0 170.0
4 360.0 170.0
5 180.0 85.0
6 90.0 42.5
7 45.0 21.25
8 22,5 10.625
9 11.25 5.3125
10 5.625 2.62625
11 2.8125 1.328125
12 1.40625 0.6640625
13 0.703125 0.33203125
14 0.3515625 0.166015625
15 0.17578125 0.0830078125
16 0.087890625 0.0415039063
17 0.0439453125 0.0207519531
18 0.0219726563 0.0103759766
19 0.0109863281 0.0051879883
20 0.0054931641 0.0025939941

Utiliza a API Obter Imagem de Mapa: https://docs.microsoft.com/rest/api/maps/render/getmapimage

function getMapImage(aborter: Aborter, options: GetMapImageOptions): Promise<GetMapImageResponse>

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 o cancelamento do pedido.

options
GetMapImageOptions

Devoluções

Promise<GetMapImageResponse>

getMapImageryTile(Aborter, number, number, number)

Devolve um mosaico de imagem de mapa com o tamanho 256x256, dadas as coordenadas x e y e o nível de zoom. O nível de zoom varia entre 0 e 18. O valor de estilo disponível atual é "satélite", que fornece apenas imagens de satélite. Utiliza a API de Mosaico Obter Imagens do Mapa: https://docs.microsoft.com/rest/api/maps/render/getmapimagerytile

function getMapImageryTile(aborter: Aborter, zoom: number, xTileIndex: number, yTileIndex: number): Promise<GetMapImageryTileResponse>

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 o cancelamento do pedido.

zoom

number

Nível de zoom para o mosaico pretendido. O valor de zoom tem de estar no intervalo: 0-18 (inclusive).

Veja Níveis de Zoom e Grelha de Mosaicos para obter detalhes.

xTileIndex

number

Coordenada X do mosaico na grelha de zoom. O valor tem de estar no intervalo [0, 2zoom -1].

Veja Níveis de Zoom e Grelha de Mosaicos para obter detalhes.

yTileIndex

number

Coordenada Y do mosaico na grelha de zoom. O valor tem de estar no intervalo [0, 2zoom -1].

Veja Níveis de Zoom e Grelha de Mosaicos para obter detalhes.

Devoluções

Promise<GetMapImageryTileResponse>

getMapTile(Aborter, TileFormat, MapTileLayer, MapTileStyle, number, number, number, GetMapTileOptions)

Devolve um mosaico de mapa no formato vetor ou raster normalmente para ser integrado num novo controlo de mapa ou SDK. Por predefinição, o Azure utiliza mosaicos de mapa de vetores para o respetivo controlo de mapa Web (veja Níveis de Zoom e Grelha de Mosaicos) Utiliza a API Obter Mosaico de Mapa: https://docs.microsoft.com/rest/api/maps/render/getmaptile

function getMapTile(aborter: Aborter, format: TileFormat, layer: MapTileLayer, style: MapTileStyle, zoom: number, xTileIndex: number, yTileIndex: number, options?: GetMapTileOptions): Promise<GetMapTileResponse>

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 o cancelamento do pedido.

format
TileFormat

Formato pretendido da resposta. Os valores possíveis são png & pbf. Os valores possíveis incluem: "png", "pbf"

layer
MapTileLayer

Camada de mapa pedida. Os valores possíveis são básicos, híbridos, etiquetas e terra. Os valores possíveis incluem: "básico", "híbrido", "etiquetas", "terra"

style
MapTileStyle

Estilo de mapa a devolver. Os valores possíveis são principais & shaded_relief. Os valores possíveis incluem: "main", "shaded_relief"

zoom

number

Nível de zoom para o mosaico pretendido. Para mosaicos raster , o valor tem de estar no intervalo: 0-18 (inclusive). Mosaicos raster terra, os valores têm de estar no intervalo 0-6 (inclusive). Para mosaicos de vetor , o valor tem de estar no intervalo: 0-22 (inclusive).

Veja Níveis de Zoom e Grelha de Mosaicos para obter detalhes.

xTileIndex

number

Coordenada X do mosaico na grelha de zoom. O valor tem de estar no intervalo [0, 2zoom -1].

Veja Níveis de Zoom e Grelha de Mosaicos para obter detalhes.

yTileIndex

number

Coordenada Y do mosaico na grelha de zoom. O valor tem de estar no intervalo [0, 2zoom -1].

Veja Níveis de Zoom e Grelha de Mosaicos para obter detalhes.

options
GetMapTileOptions

Devoluções

Promise<GetMapTileResponse>

Detalhes do Método Herdado

newPipeline(Credential, INewPipelineOptions)

Um método estático utilizado para criar um novo objeto pipeline com credenciais fornecidas.

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

Parâmetros

credential
Credential

Como SubscriptionKeyCredential, TokenCredential e MapControlCredential.

pipelineOptions
INewPipelineOptions

Devoluções

Pipeline

Um novo objeto pipeline.

Herdado deMapsURL.newPipeline