Share via

RenderGetMapImageOptionalParams interface

  • Referência
Pacote:
azure-maps-rest

Parâmetros Opcionais.

Extends

RequestOptionsBase

Propriedades

bbox

Caixa delimitadora. Projeção utilizada – EPSG:3857. Formato: "minLon, minLat, maxLon, maxLat". Nota: o bbox ou o centro são parâmetros necessários. São mutuamente exclusivos. Não deve ser utilizado com altura ou largura.

Os intervalos máximos permitidos para Lat e Lon são definidos para cada nível de zoom na tabela na parte superior desta página.
center

Coordenadas do ponto central. Formato: "lon,lat". Projeção utilizada

  • EPSG:3857. Intervalo de longitude: -180 a 180. Intervalo de latitude: -85 a 85. Nota: o centro ou o bbox são parâmetros necessários. São mutuamente exclusivos.
height

Altura da imagem resultante em píxeis. O intervalo é de 1 a 8192. A predefinição é 512. Não deve ser utilizado com bbox.
language

Idioma no qual os resultados da pesquisa devem ser devolvidos. Deve ser uma das etiquetas de linguagem IETF suportadas, não sensível a maiúsculas e minúsculas. Quando os dados no idioma especificado não estão disponíveis para um campo específico, é utilizado o idioma predefinido. Consulte idiomas suportados para obter detalhes.
layer

Camada de mapa pedida. Se a camada estiver definida como etiquetas ou híbrida, o formato deve ser png. Os valores possíveis incluem: "básico", "híbrido", "etiquetas"
path

Estilo e localizações do caminho. Utilize este parâmetro para adicionar opcionalmente linhas, polígonos ou círculos à imagem. O estilo de caminho descreve o aspeto da linha e do preenchimento. (Certifique-se de que codifica corretamente valores de codificação de URL deste parâmetro, uma vez que irá conter carateres reservados, como pipes e pontuação.) O parâmetro path é suportado no SKU Azure Maps conta a partir do S1. Várias instâncias do parâmetro path permitem especificar várias geometrias com os respetivos estilos. O número de parâmetros por pedido está limitado a 10 e o número de localizações está limitado a 100 por caminho.

Para compor um círculo com raio de 100 metros e ponto central na latitude 45°N e longitude 122°W com o estilo predefinido, adicione o parâmetro querystring

path=ra100||-122 45

Tenha em atenção que a longitude vem antes da latitude. Após a codificação do URL, terá o seguinte aspeto

path=ra100%7C%7C-122+45

Todos os exemplos aqui apresentados mostram o parâmetro path sem codificação de URL, para maior clareza.

Para compor uma linha, separe cada localização com um caráter de pipe. Por exemplo, utilize

path=||-122 45|-119.5 43.2|-121.67 47.12

Para compor um polígono, a última localização tem de ser igual à localização inicial. Por exemplo, utilize

path=||-122 45|-119.5 43.2|-121.67 47.12|-122 45

Os valores de longitude e latitude para localizações de linhas e polígonos podem estar entre -360 e 360 para permitir a composição de geometrias que atravessam o anti-meridiano.

Modificadores de Estilo

Pode modificar o aspeto do caminho ao adicionar modificadores de estilo. Estes são adicionados antes das localizações. Os modificadores de estilo têm um nome de duas letras. Estes nomes abreviados são utilizados para ajudar a reduzir o comprimento do URL.

Para alterar a cor do contorno, utilize o modificador de estilo "lc" e especifique a cor utilizando o formato de cor RGB HTML/CSS, que é um número hexadecimal de seis dígitos (o formulário de três dígitos não é suportado). Por exemplo, para utilizar uma cor cor-de-rosa profunda que especificaria como #FF1493 no CSS, utilize

path=lcFF1493||-122 45|-119.5 43.2

Podem ser combinados vários modificadores de estilo para criar um estilo visual mais complexo.

lc0000FF|lw3|la0.60|fa0.50||-122.2 47.6|-122.2 47.7|-122.3 47.7|-122.3 47.6|-122.2 47.6

Obter localizações de Caminho a partir do Armazenamento de Dados do Azure Maps

Para todos os SKUs de conta Azure Maps que não S0, as informações de localização do caminho podem ser obtidas a partir do Armazenamento de Dados do Azure Maps. Depois de carregar um documento GeoJSON que contém localizações de caminho, o serviço de Armazenamento de Dados devolve um ID de Dados Exclusivos (UDID) que pode utilizar para referenciar os dados no parâmetro path.

Para utilizar a geometria de ponto de um documento GeoJSON carregado como localizações de caminho, especifique o UDID na secção locations do parâmetro path. Por exemplo,

path=||udid-29dc105a-dee7-409f-a3f9-22b066ae4713

Tenha em atenção que não é permitido misturar localizações de caminho a partir do Armazenamento de Dados com localizações especificadas no parâmetro path.

Resumo do Modificador de Estilos

Modificador Description Intervalo
lc Cor da linha 000000 para FFFFFF
fc Cor de preenchimento 000000 para FFFFFF
la Alfa de linha (opacidade) 0 a 1
fa Preencher alfa (opacidade) 0 a 1
lw Largura da linha Maior que 0
ra Raio circular (medidores) Maior que 0
pins

Estilo de pushpin e instâncias. Utilize este parâmetro para, opcionalmente, adicionar pushpins à imagem. O estilo pushpin descreve o aspeto dos pushpins e as instâncias especificam as coordenadas dos pinos pushpins e etiquetas opcionais para cada pino. (Certifique-se de que codifica corretamente valores de codificação de URL deste parâmetro, uma vez que conterá carateres reservados, como pipes e pontuação.) O SKU S0 da conta Azure Maps só suporta uma única instância do parâmetro de pins. Outros SKUs permitem que várias instâncias do parâmetro pins especifiquem múltiplos estilos de pin.

Para compor um pushpin na latitude 45°N e longitude 122°W com o estilo de pushpin incorporado predefinido, adicione o parâmetro querystring

pins=default||-122 45

Tenha em atenção que a longitude vem antes da latitude. Após a codificação do URL, será semelhante a

pins=default%7C%7C-122+45

Todos os exemplos aqui mostram o parâmetro pins sem codificação de URL, para maior clareza.

Para compor um pino em várias localizações, separe cada localização com um caráter de pipe. Por exemplo, utilize

pins=default||-122 45|-119.5 43.2|-121.67 47.12

O SKU da conta de Azure Maps S0 só permite cinco pushpins. Outros SKUs de conta não têm esta limitação.

Modificadores de Estilo

Pode modificar o aspeto dos pinos ao adicionar modificadores de estilo. Estes são adicionados após o estilo, mas antes das localizações e etiquetas. Os modificadores de estilo têm um nome de duas letras. Estes nomes abreviados são utilizados para ajudar a reduzir o comprimento do URL.

Para alterar a cor do pushpin, utilize o modificador de estilo "co" e especifique a cor com o formato de cor HTML/CSS RGB, que é um número hexadecimal de seis dígitos (o formulário de três dígitos não é suportado). Por exemplo, para utilizar uma cor cor-de-rosa profunda que especificaria como #FF1493 no CSS, utilize

pins=default|coFF1493||-122 45

Etiquetas pushpin

Para adicionar uma etiqueta aos pinos, coloque a etiqueta em plicas imediatamente antes das coordenadas. Por exemplo, para etiquetar três pinos com os valores "1", "2" e "3", utilize

pins=default||'1'-122 45|'2'-119.5 43.2|'3'-121.67 47.12

Existe um estilo de pushpin incorporado chamado "nenhum" que não apresenta uma imagem pushpin. Pode utilizá-lo se quiser apresentar etiquetas sem qualquer imagem de afixação. Por exemplo,

pins=none||'A'-122 45|'B'-119.5 43.2

Para alterar a cor das etiquetas pushpin, utilize o modificador de estilo de cor de etiqueta "lc". Por exemplo, para utilizar pinos cor-de-rosa com etiquetas pretas, utilize

pins=default|coFF1493|lc000000||-122 45

Para alterar o tamanho das etiquetas, utilize o modificador de estilo de tamanho de etiqueta "ls". O tamanho da etiqueta representa a altura aproximada do texto da etiqueta em píxeis. Por exemplo, para aumentar o tamanho da etiqueta para 12, utilize

pins=default|ls12||'A'-122 45|'B'-119 43

As etiquetas estão centradas na "âncora de etiqueta" pushpin. A localização da âncora está predefinida para os pushpins incorporados e está no centro superior dos pushpins personalizados (consulte abaixo). Para substituir a âncora de etiquetas, utilize o modificador de estilo "la" e forneça coordenadas de pixéis X e Y para a âncora. Estas coordenadas são relativas ao canto superior esquerdo da imagem pushpin. Os valores X positivos movem a âncora para a direita e os valores Y positivos movem a âncora para baixo. Por exemplo, para posicionar a âncora de etiquetas 10 píxeis à direita e 4 píxeis acima do canto superior esquerdo da imagem pushpin, utilize

pins=default|la10 -4||'A'-122 45|'B'-119 43

Pushpins Personalizados

Para utilizar uma imagem pushpin personalizada, utilize a palavra "personalizado" como o nome do estilo do pin e, em seguida, especifique um URL após a localização e as informações da etiqueta. Utilize dois carateres de pipe para indicar que acabou de especificar localizações e que está a iniciar o URL. Por exemplo,

pins=custom||-122 45||http://contoso.com/pushpins/red.png

Após a codificação do URL, teria o seguinte aspeto

pins=custom%7C%7C-122+45%7C%7Chttp%3A%2F%2Fcontoso.com%2Fpushpins%2Fred.png

Por predefinição, as imagens pushpin personalizadas são desenhadas centradas nas coordenadas do pin. Normalmente, isto não é ideal, pois obscurece a localização que está a tentar realçar. Para substituir a localização da âncora da imagem do pin, utilize o modificador de estilo "an". Esta ação utiliza o mesmo formato que o modificador de estilo de âncora de etiqueta "la". Por exemplo, se a sua imagem de afixação personalizada tiver a ponta do pino no canto superior esquerdo da imagem, pode definir a âncora para esse local utilizando

pins=custom|an0 0||-122 45||http://contoso.com/pushpins/red.png

Nota: se utilizar o modificador de cores "co" com uma imagem pushpin personalizada, a cor especificada substituirá os canais RGB dos píxeis na imagem, mas deixará o canal alfa (opacidade) inalterado. Normalmente, isto só seria feito com uma imagem personalizada de cores sólidas.

Obter Pushpins do Armazenamento de Dados Azure Maps

Para todos os SKUs de conta Azure Maps que não S0, as informações de localização e imagem pushpin podem ser obtidas a partir do Armazenamento de Dados Azure Maps. Depois de carregar uma imagem pushpin ou um documento GeoJSON que contenha localizações de afixação, o serviço armazenamento de dados devolve um ID de Dados Exclusivo (UDID) que pode utilizar para referenciar os dados no parâmetro pins.

Para utilizar uma imagem pushpin personalizada do Armazenamento de Dados Azure Maps, especifique o prefixo UDID de "udid-" como o nome do estilo pushpin. Por exemplo,

pins=udid-fe22c504-3a81-4fcd-adc6-a3507ce866c1||-122 45

Para utilizar a geometria de ponto de um documento GeoJSON carregado como localizações de afixação, especifique a UDID na secção localizações do parâmetro pins. Por exemplo,

pins=default||udid-29dc105a-dee7-409f-a3f9-22b066ae4713

Tenha em atenção que apenas será utilizada geometria de pontos e múltiplos pontos, pontos e vários pontos de coleções de geometria e geometria de pontos de funcionalidades. A geometria de linhas e polígonos será ignorada. Se o ponto for proveniente de uma funcionalidade e a funcionalidade tiver uma propriedade de cadeia denominada "etiqueta", o valor dessa propriedade será utilizado como a etiqueta do pin.

Pode misturar localizações de afixar a partir do Armazenamento de Dados e afixar localizações especificadas no parâmetro pins. Qualquer uma das localizações dos pinos delimitados por tubos pode ser uma longitude e latitude ou uma UDID. Por exemplo,

pins=default||-122 45|udid-29dc105a-dee7-409f-a3f9-22b066ae4713|-119 43

Dimensionamento, Rotação e Opacidade

Pode tornar os pushpins e as respetivas etiquetas maiores ou menores com o modificador de estilo de escala "sc". Este é um valor maior que zero. Um valor de 1 é a escala padrão. Os valores maiores do que 1 aumentarão os pinos e os valores inferiores a 1 irão torná-los mais pequenos. Por exemplo, para desenhar os pushpins 50% maiores do que o normal, utilize

pins=default|sc1.5||-122 45

Pode rodar os pushpins e as respetivas etiquetas com o modificador de estilo de rotação "ro". Este é um número de graus de rotação no sentido dos ponteiros do relógio. Utilize um número negativo para rodar no sentido contrário ao dos ponteiros do relógio. Por exemplo, para rodar os pushpins 90 graus no sentido dos ponteiros do relógio e duplicar o tamanho, utilize

pins=default|ro90|sc2||-122 45

Pode tornar os pushpins e as etiquetas parcialmente transparentes ao especificar o modificador de estilo alfa "al". Este é um número entre 0 e 1 que indica a opacidade dos pushpins. Zero torna-os completamente transparentes (e não visíveis) e 1 torna-os completamente opacos (que é a predefinição). Por exemplo, para tornar os pushpins e as respetivas etiquetas apenas 67% opacos, utilize

pins=default|al.67||-122 45

Resumo do Modificador de Estilos

Modificador Description Intervalo
al Alfa (opacidade) 0 a 1
mar Afixar âncora *
co Afixar cor 0000000 para FFFFFF
la Âncora de etiquetas *
lc Cor da etiqueta 0000000 para FFFFFF
ls Tamanho da etiqueta Maior que 0
ro Rotação -360 a 360
sc Escala Maior que 0
  • As coordenadas X e Y podem estar em qualquer lugar dentro da imagem de afixação ou de uma margem à sua volta. O tamanho da margem é o mínimo da largura e altura do pino.
style

Estilo de mapa a devolver. Atualmente, apenas o estilo disponível é principal. Os valores possíveis incluem: "principal"
view

O parâmetro Ver especifica o conjunto de conteúdos geopolíticos contestados que é devolvido através de serviços Azure Maps, incluindo limites e etiquetas apresentados no mapa. O parâmetro Ver (também denominado "parâmetro da região do utilizador") mostrará os mapas corretos para esse país/região. Por predefinição, o parâmetro Ver está definido como "Unificado", mesmo que não o tenha definido no pedido. É da sua responsabilidade determinar a localização dos seus utilizadores e, em seguida, definir o parâmetro Ver corretamente para essa localização. Em alternativa, tem a opção de definir "View=Auto", que devolverá os dados do mapa com base no endereço IP do pedido. O parâmetro Ver no Azure Maps tem de ser utilizado em conformidade com as leis aplicáveis, incluindo as relativas ao mapeamento, do país onde são disponibilizados mapas, imagens e outros dados e conteúdos de terceiros aos quais está autorizado a aceder através de Azure Maps. Exemplo: view=IN. Consulte Vistas Suportadas para obter detalhes e para ver as Vistas disponíveis.
width

Largura da imagem resultante em píxeis. O intervalo é de 1 a 8192. A predefinição é 512. Não deve ser utilizado com bbox.
zoom

Nível de zoom pretendido do mapa. O valor de zoom tem de estar no intervalo: 0-20 (inclusive). O valor predefinido é 12.

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

Propriedades Herdadas

abortSignal

O sinal que pode ser utilizado para abortar pedidos.
customHeaders

{object} [customHeaders] Cabeçalhos de pedido personalizados definidos pelo utilizador que serão aplicados antes do pedido ser enviado.
onDownloadProgress

Chamada de retorno que é acionada após o progresso da transferência.
onUploadProgress

Chamada de retorno que é acionada após o progresso do carregamento.
timeout

O número de milissegundos que um pedido pode tomar antes de ser terminado automaticamente.

Detalhes de Propriedade

bbox

Caixa delimitadora. Projeção utilizada – EPSG:3857. Formato: "minLon, minLat, maxLon, maxLat". Nota: o bbox ou o centro são parâmetros necessários. São mutuamente exclusivos. Não deve ser utilizado com altura ou largura.

Os intervalos máximos permitidos para Lat e Lon são definidos para cada nível de zoom na tabela na parte superior desta página.

bbox?: string

Valor de Propriedade

string

center

Coordenadas do ponto central. Formato: "lon,lat". Projeção utilizada

  • EPSG:3857. Intervalo de longitude: -180 a 180. Intervalo de latitude: -85 a 85. Nota: o centro ou o bbox são parâmetros necessários. São mutuamente exclusivos.
center?: string

Valor de Propriedade

string

height

Altura da imagem resultante em píxeis. O intervalo é de 1 a 8192. A predefinição é 512. Não deve ser utilizado com bbox.

height?: number

Valor de Propriedade

number

language

Idioma no qual os resultados da pesquisa devem ser devolvidos. Deve ser uma das etiquetas de linguagem IETF suportadas, não sensível a maiúsculas e minúsculas. Quando os dados no idioma especificado não estão disponíveis para um campo específico, é utilizado o idioma predefinido. Consulte idiomas suportados para obter detalhes.

language?: string

Valor de Propriedade

string

layer

Camada de mapa pedida. Se a camada estiver definida como etiquetas ou híbrida, o formato deve ser png. Os valores possíveis incluem: "básico", "híbrido", "etiquetas"

layer?: StaticMapLayer

Valor de Propriedade

StaticMapLayer

path

Estilo e localizações do caminho. Utilize este parâmetro para adicionar opcionalmente linhas, polígonos ou círculos à imagem. O estilo de caminho descreve o aspeto da linha e do preenchimento. (Certifique-se de que codifica corretamente valores de codificação de URL deste parâmetro, uma vez que irá conter carateres reservados, como pipes e pontuação.) O parâmetro path é suportado no SKU Azure Maps conta a partir do S1. Várias instâncias do parâmetro path permitem especificar várias geometrias com os respetivos estilos. O número de parâmetros por pedido está limitado a 10 e o número de localizações está limitado a 100 por caminho.

Para compor um círculo com raio de 100 metros e ponto central na latitude 45°N e longitude 122°W com o estilo predefinido, adicione o parâmetro querystring

path=ra100||-122 45

Tenha em atenção que a longitude vem antes da latitude. Após a codificação do URL, terá o seguinte aspeto

path=ra100%7C%7C-122+45

Todos os exemplos aqui apresentados mostram o parâmetro path sem codificação de URL, para maior clareza.

Para compor uma linha, separe cada localização com um caráter de pipe. Por exemplo, utilize

path=||-122 45|-119.5 43.2|-121.67 47.12

Para compor um polígono, a última localização tem de ser igual à localização inicial. Por exemplo, utilize

path=||-122 45|-119.5 43.2|-121.67 47.12|-122 45

Os valores de longitude e latitude para localizações de linhas e polígonos podem estar entre -360 e 360 para permitir a composição de geometrias que atravessam o anti-meridiano.

Modificadores de Estilo

Pode modificar o aspeto do caminho ao adicionar modificadores de estilo. Estes são adicionados antes das localizações. Os modificadores de estilo têm um nome de duas letras. Estes nomes abreviados são utilizados para ajudar a reduzir o comprimento do URL.

Para alterar a cor do contorno, utilize o modificador de estilo "lc" e especifique a cor utilizando o formato de cor RGB HTML/CSS, que é um número hexadecimal de seis dígitos (o formulário de três dígitos não é suportado). Por exemplo, para utilizar uma cor cor-de-rosa profunda que especificaria como #FF1493 no CSS, utilize

path=lcFF1493||-122 45|-119.5 43.2

Podem ser combinados vários modificadores de estilo para criar um estilo visual mais complexo.

lc0000FF|lw3|la0.60|fa0.50||-122.2 47.6|-122.2 47.7|-122.3 47.7|-122.3 47.6|-122.2 47.6

Obter localizações de Caminho a partir do Armazenamento de Dados do Azure Maps

Para todos os SKUs de conta Azure Maps que não S0, as informações de localização do caminho podem ser obtidas a partir do Armazenamento de Dados do Azure Maps. Depois de carregar um documento GeoJSON que contém localizações de caminho, o serviço de Armazenamento de Dados devolve um ID de Dados Exclusivos (UDID) que pode utilizar para referenciar os dados no parâmetro path.

Para utilizar a geometria de ponto de um documento GeoJSON carregado como localizações de caminho, especifique o UDID na secção locations do parâmetro path. Por exemplo,

path=||udid-29dc105a-dee7-409f-a3f9-22b066ae4713

Tenha em atenção que não é permitido misturar localizações de caminho a partir do Armazenamento de Dados com localizações especificadas no parâmetro path.

Resumo do Modificador de Estilos

Modificador Description Intervalo
lc Cor da linha 000000 para FFFFFF
fc Cor de preenchimento 000000 para FFFFFF
la Alfa de linha (opacidade) 0 a 1
fa Preencher alfa (opacidade) 0 a 1
lw Largura da linha Maior que 0
ra Raio circular (medidores) Maior que 0 
path?: string[]

Valor de Propriedade

string[]

pins

Estilo de pushpin e instâncias. Utilize este parâmetro para, opcionalmente, adicionar pushpins à imagem. O estilo pushpin descreve o aspeto dos pushpins e as instâncias especificam as coordenadas dos pinos pushpins e etiquetas opcionais para cada pino. (Certifique-se de que codifica corretamente valores de codificação de URL deste parâmetro, uma vez que conterá carateres reservados, como pipes e pontuação.) O SKU S0 da conta Azure Maps só suporta uma única instância do parâmetro de pins. Outros SKUs permitem que várias instâncias do parâmetro pins especifiquem múltiplos estilos de pin.

Para compor um pushpin na latitude 45°N e longitude 122°W com o estilo de pushpin incorporado predefinido, adicione o parâmetro querystring

pins=default||-122 45

Tenha em atenção que a longitude vem antes da latitude. Após a codificação do URL, será semelhante a

pins=default%7C%7C-122+45

Todos os exemplos aqui mostram o parâmetro pins sem codificação de URL, para maior clareza.

Para compor um pino em várias localizações, separe cada localização com um caráter de pipe. Por exemplo, utilize

pins=default||-122 45|-119.5 43.2|-121.67 47.12

O SKU da conta de Azure Maps S0 só permite cinco pushpins. Outros SKUs de conta não têm esta limitação.

Modificadores de Estilo

Pode modificar o aspeto dos pinos ao adicionar modificadores de estilo. Estes são adicionados após o estilo, mas antes das localizações e etiquetas. Os modificadores de estilo têm um nome de duas letras. Estes nomes abreviados são utilizados para ajudar a reduzir o comprimento do URL.

Para alterar a cor do pushpin, utilize o modificador de estilo "co" e especifique a cor com o formato de cor HTML/CSS RGB, que é um número hexadecimal de seis dígitos (o formulário de três dígitos não é suportado). Por exemplo, para utilizar uma cor cor-de-rosa profunda que especificaria como #FF1493 no CSS, utilize

pins=default|coFF1493||-122 45

Etiquetas pushpin

Para adicionar uma etiqueta aos pinos, coloque a etiqueta em plicas imediatamente antes das coordenadas. Por exemplo, para etiquetar três pinos com os valores "1", "2" e "3", utilize

pins=default||'1'-122 45|'2'-119.5 43.2|'3'-121.67 47.12

Existe um estilo de pushpin incorporado chamado "nenhum" que não apresenta uma imagem pushpin. Pode utilizá-lo se quiser apresentar etiquetas sem qualquer imagem de afixação. Por exemplo,

pins=none||'A'-122 45|'B'-119.5 43.2

Para alterar a cor das etiquetas pushpin, utilize o modificador de estilo de cor de etiqueta "lc". Por exemplo, para utilizar pinos cor-de-rosa com etiquetas pretas, utilize

pins=default|coFF1493|lc000000||-122 45

Para alterar o tamanho das etiquetas, utilize o modificador de estilo de tamanho de etiqueta "ls". O tamanho da etiqueta representa a altura aproximada do texto da etiqueta em píxeis. Por exemplo, para aumentar o tamanho da etiqueta para 12, utilize

pins=default|ls12||'A'-122 45|'B'-119 43

As etiquetas estão centradas na "âncora de etiqueta" pushpin. A localização da âncora está predefinida para os pushpins incorporados e está no centro superior dos pushpins personalizados (consulte abaixo). Para substituir a âncora de etiquetas, utilize o modificador de estilo "la" e forneça coordenadas de pixéis X e Y para a âncora. Estas coordenadas são relativas ao canto superior esquerdo da imagem pushpin. Os valores X positivos movem a âncora para a direita e os valores Y positivos movem a âncora para baixo. Por exemplo, para posicionar a âncora de etiquetas 10 píxeis à direita e 4 píxeis acima do canto superior esquerdo da imagem pushpin, utilize

pins=default|la10 -4||'A'-122 45|'B'-119 43

Pushpins Personalizados

Para utilizar uma imagem pushpin personalizada, utilize a palavra "personalizado" como o nome do estilo do pin e, em seguida, especifique um URL após a localização e as informações da etiqueta. Utilize dois carateres de pipe para indicar que acabou de especificar localizações e que está a iniciar o URL. Por exemplo,

pins=custom||-122 45||http://contoso.com/pushpins/red.png

Após a codificação do URL, teria o seguinte aspeto

pins=custom%7C%7C-122+45%7C%7Chttp%3A%2F%2Fcontoso.com%2Fpushpins%2Fred.png

Por predefinição, as imagens pushpin personalizadas são desenhadas centradas nas coordenadas do pin. Normalmente, isto não é ideal, pois obscurece a localização que está a tentar realçar. Para substituir a localização da âncora da imagem do pin, utilize o modificador de estilo "an". Esta ação utiliza o mesmo formato que o modificador de estilo de âncora de etiqueta "la". Por exemplo, se a sua imagem de afixação personalizada tiver a ponta do pino no canto superior esquerdo da imagem, pode definir a âncora para esse local utilizando

pins=custom|an0 0||-122 45||http://contoso.com/pushpins/red.png

Nota: se utilizar o modificador de cores "co" com uma imagem pushpin personalizada, a cor especificada substituirá os canais RGB dos píxeis na imagem, mas deixará o canal alfa (opacidade) inalterado. Normalmente, isto só seria feito com uma imagem personalizada de cores sólidas.

Obter Pushpins do Armazenamento de Dados Azure Maps

Para todos os SKUs de conta Azure Maps que não S0, as informações de localização e imagem pushpin podem ser obtidas a partir do Armazenamento de Dados Azure Maps. Depois de carregar uma imagem pushpin ou um documento GeoJSON que contenha localizações de afixação, o serviço armazenamento de dados devolve um ID de Dados Exclusivo (UDID) que pode utilizar para referenciar os dados no parâmetro pins.

Para utilizar uma imagem pushpin personalizada do Armazenamento de Dados Azure Maps, especifique o prefixo UDID de "udid-" como o nome do estilo pushpin. Por exemplo,

pins=udid-fe22c504-3a81-4fcd-adc6-a3507ce866c1||-122 45

Para utilizar a geometria de ponto de um documento GeoJSON carregado como localizações de afixação, especifique a UDID na secção localizações do parâmetro pins. Por exemplo,

pins=default||udid-29dc105a-dee7-409f-a3f9-22b066ae4713

Tenha em atenção que apenas será utilizada geometria de pontos e múltiplos pontos, pontos e vários pontos de coleções de geometria e geometria de pontos de funcionalidades. A geometria de linhas e polígonos será ignorada. Se o ponto for proveniente de uma funcionalidade e a funcionalidade tiver uma propriedade de cadeia denominada "etiqueta", o valor dessa propriedade será utilizado como a etiqueta do pin.

Pode misturar localizações de afixar a partir do Armazenamento de Dados e afixar localizações especificadas no parâmetro pins. Qualquer uma das localizações dos pinos delimitados por tubos pode ser uma longitude e latitude ou uma UDID. Por exemplo,

pins=default||-122 45|udid-29dc105a-dee7-409f-a3f9-22b066ae4713|-119 43

Dimensionamento, Rotação e Opacidade

Pode tornar os pushpins e as respetivas etiquetas maiores ou menores com o modificador de estilo de escala "sc". Este é um valor maior que zero. Um valor de 1 é a escala padrão. Os valores maiores do que 1 aumentarão os pinos e os valores inferiores a 1 irão torná-los mais pequenos. Por exemplo, para desenhar os pushpins 50% maiores do que o normal, utilize

pins=default|sc1.5||-122 45

Pode rodar os pushpins e as respetivas etiquetas com o modificador de estilo de rotação "ro". Este é um número de graus de rotação no sentido dos ponteiros do relógio. Utilize um número negativo para rodar no sentido contrário ao dos ponteiros do relógio. Por exemplo, para rodar os pushpins 90 graus no sentido dos ponteiros do relógio e duplicar o tamanho, utilize

pins=default|ro90|sc2||-122 45

Pode tornar os pushpins e as etiquetas parcialmente transparentes ao especificar o modificador de estilo alfa "al". Este é um número entre 0 e 1 que indica a opacidade dos pushpins. Zero torna-os completamente transparentes (e não visíveis) e 1 torna-os completamente opacos (que é a predefinição). Por exemplo, para tornar os pushpins e as respetivas etiquetas apenas 67% opacos, utilize

pins=default|al.67||-122 45

Resumo do Modificador de Estilos

Modificador Description Intervalo
al Alfa (opacidade) 0 a 1
mar Afixar âncora *
co Afixar cor 0000000 para FFFFFF
la Âncora de etiquetas *
lc Cor da etiqueta 0000000 para FFFFFF
ls Tamanho da etiqueta Maior que 0
ro Rotação -360 a 360
sc Escala Maior que 0
  • As coordenadas X e Y podem estar em qualquer lugar dentro da imagem de afixação ou de uma margem à sua volta. O tamanho da margem é o mínimo da largura e altura do pino.
pins?: string[]

Valor de Propriedade

string[]

style

Estilo de mapa a devolver. Atualmente, apenas o estilo disponível é principal. Os valores possíveis incluem: "principal"

style?: Style

Valor de Propriedade

Style

view

O parâmetro Ver especifica o conjunto de conteúdos geopolíticos contestados que é devolvido através de serviços Azure Maps, incluindo limites e etiquetas apresentados no mapa. O parâmetro Ver (também denominado "parâmetro da região do utilizador") mostrará os mapas corretos para esse país/região. Por predefinição, o parâmetro Ver está definido como "Unificado", mesmo que não o tenha definido no pedido. É da sua responsabilidade determinar a localização dos seus utilizadores e, em seguida, definir o parâmetro Ver corretamente para essa localização. Em alternativa, tem a opção de definir "View=Auto", que devolverá os dados do mapa com base no endereço IP do pedido. O parâmetro Ver no Azure Maps tem de ser utilizado em conformidade com as leis aplicáveis, incluindo as relativas ao mapeamento, do país onde são disponibilizados mapas, imagens e outros dados e conteúdos de terceiros aos quais está autorizado a aceder através de Azure Maps. Exemplo: view=IN. Consulte Vistas Suportadas para obter detalhes e para ver as Vistas disponíveis.

view?: string

Valor de Propriedade

string

width

Largura da imagem resultante em píxeis. O intervalo é de 1 a 8192. A predefinição é 512. Não deve ser utilizado com bbox.

width?: number

Valor de Propriedade

number

zoom

Nível de zoom pretendido do mapa. O valor de zoom tem de estar no intervalo: 0-20 (inclusive). O valor predefinido é 12.

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

zoom?: number

Valor de Propriedade

number

Detalhes da Propriedade Herdada

abortSignal

O sinal que pode ser utilizado para abortar pedidos.

abortSignal?: AbortSignalLike

Valor de Propriedade

AbortSignalLike

Herdado de RequestOptionsBase.abortSignal

customHeaders

{object} [customHeaders] Cabeçalhos de pedido personalizados definidos pelo utilizador que serão aplicados antes do pedido ser enviado.

customHeaders?: [key: string]: string

Valor de Propriedade

[key: string]: string

Herdado de RequestOptionsBase.customHeaders

onDownloadProgress

Chamada de retorno que é acionada após o progresso da transferência.

onDownloadProgress?: (progress: TransferProgressEvent) => void

Valor de Propriedade

(progress: TransferProgressEvent) => void

Herdado de RequestOptionsBase.onDownloadProgress

onUploadProgress

Chamada de retorno que é acionada após o progresso do carregamento.

onUploadProgress?: (progress: TransferProgressEvent) => void

Valor de Propriedade

(progress: TransferProgressEvent) => void

Herdado de RequestOptionsBase.onUploadProgress

timeout

O número de milissegundos que um pedido pode tomar antes de ser terminado automaticamente.

timeout?: number

Valor de Propriedade

number

Herdado de RequestOptionsBase.timeout