RenderGetMapImageOptionalParams interface
Parâmetros opcionais.
- Extends
-
RequestOptionsBase
Propriedades
bbox | Caixa delimitadora. Projeção usada – EPSG:3857. Formato: 'minLon, minLat, maxLon, maxLat'. Observação: bbox ou central são parâmetros necessários. Eles são mutuamente exclusivos. Ele não deve ser usado 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 usada
|
|||||||||||||||||||||||||||
height | Altura da imagem resultante em pixels. O intervalo é de 1 a 8192. O padrão é 512. Ele não deve ser usado com bbox. |
|||||||||||||||||||||||||||
language | Idioma no qual os resultados da pesquisa devem ser retornados. Deve ser uma das marcas de linguagem IETF com suporte, que não diferencia maiúsculas de minúsculas. Quando os dados no idioma especificado não estão disponíveis para um campo específico, o idioma padrão é usado. Consulte Idiomas com suporte para obter detalhes. |
|||||||||||||||||||||||||||
layer | Camada de mapa solicitada. Se a camada for definida como rótulos ou híbrido, o formato deverá ser png. Os valores possíveis incluem: 'basic', 'hybrid', 'labels' |
|||||||||||||||||||||||||||
path | Estilo de caminho e locais. Use esse parâmetro para adicionar opcionalmente linhas, polígonos ou círculos à imagem. O estilo de caminho descreve a aparência da linha e do preenchimento. (Certifique-se de codificar corretamente valores de URL desse parâmetro, pois ele conterá caracteres reservados, como pipes e pontuação.) Há suporte para o parâmetro Path no SKU da conta Azure Mapas, começando pelo S1. Várias instâncias do parâmetro path permitem especificar várias geometrias com seus estilos. O número de parâmetros por solicitação é limitado a 10 e o número de locais é limitado a 100 por caminho. Para renderizar um círculo com raio de 100 metros e ponto central na latitude 45°N e longitude 122°W usando o estilo padrão, adicione o parâmetro querystring
Observe que a longitude vem antes da latitude. Após a codificação de URL, essa aparência será semelhante a
Todos os exemplos aqui mostram o parâmetro path sem codificação de URL, para maior clareza. Para renderizar uma linha, separe cada local com um caractere de pipe. Por exemplo, use
Para renderizar um polígono, o último local deve ser igual ao local inicial. Por exemplo, use
Os valores de longitude e latitude para locais de linhas e polígonos podem estar no intervalo de -360 a 360 para permitir a renderização de geometrias que cruzam o anti-meridiano. Modificadores de estiloVocê pode modificar a aparência do caminho adicionando modificadores de estilo. Eles são adicionados antes dos locais. Cada um dos modificadores de estilo tem um nome de duas letras. Esses nomes abreviados são usados para ajudar a reduzir o comprimento da URL. Para alterar a cor da estrutura de tópicos, use o modificador de estilo 'lc' e especifique a cor usando o formato de cor HTML/CSS RGB, que é um número hexadecimal de seis dígitos (não há suporte para a forma de três dígitos). Por exemplo, para usar uma cor rosa profunda que você especificaria como #FF1493 no CSS, use
Vários modificadores de estilo podem ser combinados para criar um estilo visual mais complexo.
Obtendo locais de caminho do armazenamento de dados Azure MapasPara todos os SKUs de conta Azure Mapas que não sejam S0, as informações de localização do caminho podem ser obtidas de Azure Mapas Armazenamento de Dados. Depois de carregar um documento GeoJSON que contém locais de caminho, o serviço armazenamento de dados retorna uma UDID (ID de Dados Exclusiva) que você pode usar para fazer referência aos dados no parâmetro path. Para usar a geometria de ponto de um documento GeoJSON carregado como os locais do caminho, especifique a UDID na seção locais do parâmetro path. Por exemplo,
Observe que não é permitido misturar locais de caminho do Armazenamento de Dados com locais especificados no parâmetro path. Resumo do modificador de estilo
|
|||||||||||||||||||||||||||
pins | Estilo de pino e instâncias. Use esse parâmetro para, opcionalmente, adicionar pinos à imagem. O estilo de pino descreve a aparência dos pinos e as instâncias especificam as coordenadas dos pinos e rótulos opcionais para cada pino. (Certifique-se de codificar corretamente valores de URL desse parâmetro, pois ele conterá caracteres reservados, como pipes e pontuação.) O SKU S0 da conta Azure Mapas dá suporte apenas a uma única instância do parâmetro pins. Outras SKUs permitem que várias instâncias do parâmetro pins especifiquem vários estilos de pin. Para renderizar um pino em latitude 45°N e longitude 122°W usando o estilo de pino interno padrão, adicione o parâmetro querystring
Observe que a longitude vem antes da latitude. Após a codificação de URL, essa aparência será semelhante a
Todos os exemplos aqui mostram o parâmetro pins sem codificação de URL, para maior clareza. Para renderizar um pino em vários locais, separe cada local com um caractere de pipe. Por exemplo, use
O SKU da conta de Azure Mapas S0 permite apenas cinco pinos. Outras SKUs de conta não têm essa limitação. Modificadores de estiloÉ possível modificar a aparência dos pinos adicionando modificadores de estilo. Eles são adicionados após o estilo, mas antes dos locais e rótulos. Cada um dos modificadores de estilo tem um nome de duas letras. Esses nomes abreviados são usados para ajudar a reduzir o comprimento da URL. Para alterar a cor do pino, use o modificador de estilo 'co' e especifique a cor usando o formato de cor HTML/CSS RGB, que é um número hexadecimal de seis dígitos (não há suporte para a forma de três dígitos). Por exemplo, para usar uma cor rosa profunda que você especificaria como #FF1493 no CSS, use
Rótulos de pinoPara adicionar um rótulo aos pinos, coloque o rótulo entre aspas simples pouco antes das coordenadas. Por exemplo, para rotular três pinos com os valores '1', '2' e '3', use
Há um estilo de pino interno chamado 'none' que não exibe uma imagem de pino. Você pode usar isso se quiser exibir rótulos sem nenhuma imagem de fixação. Por exemplo,
Para alterar a cor dos rótulos de pino, use o modificador de estilo de cor do rótulo 'lc'. Por exemplo, para usar pinos rosa com rótulos pretos, use
Para alterar o tamanho dos rótulos, use o modificador de estilo de tamanho de rótulo 'ls'. O tamanho do rótulo representa a altura aproximada do texto do rótulo em pixels. Por exemplo, para aumentar o tamanho do rótulo para 12, use
Os rótulos são centralizados no pushpin 'label anchor'. O local da âncora é predefinido para pinos internos e está no centro superior de pinos personalizados (veja abaixo). Para substituir a âncora de rótulo, use o modificador de estilo 'la' e forneça coordenadas de pixel X e Y para a âncora. Essas coordenadas são relativas ao canto superior esquerdo da imagem de pino. Os valores positivos X movem a âncora para a direita e os valores Y positivos movem a âncora para baixo. Por exemplo, para posicionar a âncora de rótulo 10 pixels para a direita e 4 pixels acima do canto superior esquerdo da imagem de pino, use
Pinos personalizadosPara usar uma imagem de pushpin personalizada, use a palavra "personalizado" como o nome do estilo do pino e especifique uma URL após as informações de localização e rótulo. Use dois caracteres de pipe para indicar que você terminou de especificar locais e está iniciando a URL. Por exemplo,
Após a codificação de URL, isso teria a aparência
Por padrão, as imagens de pino personalizadas são desenhadas centralizada nas coordenadas do pino. Isso geralmente não é ideal, pois obscurece o local que você está tentando realçar. Para substituir o local de âncora da imagem de pino, use o modificador de estilo 'an'. Isso usa o mesmo formato que o modificador de estilo de âncora de rótulo 'la'. Por exemplo, se sua imagem de fixação personalizada tiver a ponta do pino no canto superior esquerdo da imagem, você poderá definir a âncora para esse ponto usando
Observação: se você usar o modificador de cor 'co' com uma imagem de pino personalizada, a cor especificada substituirá os canais RGB dos pixels na imagem, mas deixará o canal alfa (opacidade) inalterado. Isso normalmente só seria feito com uma imagem personalizada de cor sólida. Obtendo pushpins do armazenamento de dados Azure MapasPara todos os SKUs de conta Azure Mapas que não sejam S0, as informações de localização e imagem de pushpin podem ser obtidas de Azure Mapas Armazenamento de Dados. Depois de carregar uma imagem de pushpin ou um documento GeoJSON que contém locais de pino, o serviço armazenamento de dados retorna uma ID de Dados Exclusiva (UDID) que você pode usar para referenciar os dados no parâmetro pins. Para usar uma imagem de pushpin personalizada do armazenamento de dados Azure Mapas, especifique o UDID prefixado por 'udid-' como o nome do estilo de pino. Por exemplo,
Para usar a geometria de ponto de um documento GeoJSON carregado como locais de fixação, especifique a UDID na seção locais do parâmetro pins. Por exemplo,
Observe que somente geometria de ponto e multiponto, pontos e vários pontos de coleções de geometria e geometria de ponto dos recursos serão usados. A linhagem e a geometria do polígono serão ignoradas. Se o ponto for proveniente de um recurso e o recurso tiver uma propriedade de cadeia de caracteres chamada "label", o valor dessa propriedade será usado como o rótulo do pino. Você pode misturar locais de fixação do Armazenamento de Dados e fixar locais especificados no parâmetro pins. Qualquer um dos locais de pino delimitados por pipe pode ser uma longitude e latitude ou um UDID. Por exemplo,
Escala, rotação e opacidadeÉ possível criar pinos e rótulos maiores ou menores, usando o modificador de estilo de escala 'sc'. Esse é um valor maior que zero. Um valor de 1 é a escala padrão. Valores maiores que 1 tornarão os marcadores maiores e valores menores que 1 os tornarão menores. Por exemplo, para desenhar os pinos 50% maiores que o normal, use
Você pode girar os pinos e seus rótulos usando o modificador de estilo de rotação 'ro'. Esse é um número de graus de rotação no sentido horário. Use um número negativo para girar no sentido anti-horário. Por exemplo, para girar os pinos 90 graus no sentido horário e dobrar seu tamanho, use
Você pode tornar os pinos e seus rótulos parcialmente transparentes especificando o modificador de estilo alfa 'al'. Esse é um número entre 0 e 1 que indica a opacidade dos pinos. Zero os torna completamente transparentes (e não visíveis) e 1 os torna completamente opacos (que é o padrão). Por exemplo, para tornar os pinos e seus rótulos apenas 67% opacos, use
Resumo do modificador de estilo
|
|||||||||||||||||||||||||||
style | Estilo de mapa a ser retornado. Atualmente, somente o estilo disponível é main. Os valores possíveis incluem: 'main' |
|||||||||||||||||||||||||||
view | O parâmetro View especifica qual conjunto de conteúdo geopoliticamente disputado é retornado por meio de serviços de Azure Mapas, incluindo bordas e rótulos exibidos no mapa. O parâmetro View (também conhecido como "parâmetro de região do usuário") mostrará os mapas corretos para esse país/região. Por padrão, o parâmetro View é definido como "Unificado", mesmo que você não o tenha definido na solicitação. É sua responsabilidade determinar a localização de seus usuários e, em seguida, definir o parâmetro View corretamente para esse local. Como alternativa, você tem a opção de definir 'View=Auto', que retornará os dados do mapa com base no endereço IP da solicitação. O parâmetro View no Azure Mapas deve ser usado em conformidade com as leis aplicáveis, incluindo aquelas relativas ao mapeamento, do país em que são disponibilizados mapas, imagens e outros dados e conteúdo de terceiros que você está autorizado a acessar por meio de Azure Mapas. Exemplo: view=IN. Consulte Modos de exibição com suporte para obter detalhes e para ver as Exibições disponíveis. |
|||||||||||||||||||||||||||
width | Largura da imagem resultante em pixels. O intervalo é de 1 a 8192. O padrão é 512. Ele não deve ser usado com bbox. |
|||||||||||||||||||||||||||
zoom | Nível de zoom desejado do mapa. O valor de zoom deve estar no intervalo: 0 a 20 (inclusive). O valor padrão é 12. |
Propriedades herdadas
abort |
O sinal que pode ser usado para anular solicitações. |
custom |
{object} [customHeaders] Cabeçalhos de solicitação personalizados definidos pelo usuário que serão aplicados antes do envio da solicitação. |
on |
Retorno de chamada que é disparado após o progresso do download. |
on |
Retorno de chamada que é disparado após o progresso do upload. |
timeout | O número de milissegundos que uma solicitação pode levar antes de ser encerrada automaticamente. |
Detalhes da propriedade
bbox
Caixa delimitadora. Projeção usada – EPSG:3857. Formato: 'minLon, minLat, maxLon, maxLat'. Observação: bbox ou central são parâmetros necessários. Eles são mutuamente exclusivos. Ele não deve ser usado 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 da propriedade
string
center
Coordenadas do ponto central. Formato: 'lon,lat'. Projeção usada
- EPSG:3857. Intervalo de longitude: -180 a 180. Intervalo de latitude: -85 a 85. Observação: os parâmetros central ou bbox são necessários. Eles são mutuamente exclusivos.
center?: string
Valor da propriedade
string
height
Altura da imagem resultante em pixels. O intervalo é de 1 a 8192. O padrão é 512. Ele não deve ser usado com bbox.
height?: number
Valor da propriedade
number
language
Idioma no qual os resultados da pesquisa devem ser retornados. Deve ser uma das marcas de linguagem IETF com suporte, que não diferencia maiúsculas de minúsculas. Quando os dados no idioma especificado não estão disponíveis para um campo específico, o idioma padrão é usado. Consulte Idiomas com suporte para obter detalhes.
language?: string
Valor da propriedade
string
layer
Camada de mapa solicitada. Se a camada for definida como rótulos ou híbrido, o formato deverá ser png. Os valores possíveis incluem: 'basic', 'hybrid', 'labels'
layer?: StaticMapLayer
Valor da propriedade
path
Estilo de caminho e locais. Use esse parâmetro para adicionar opcionalmente linhas, polígonos ou círculos à imagem. O estilo de caminho descreve a aparência da linha e do preenchimento. (Certifique-se de codificar corretamente valores de URL desse parâmetro, pois ele conterá caracteres reservados, como pipes e pontuação.) Há suporte para o parâmetro Path no SKU da conta Azure Mapas, começando pelo S1. Várias instâncias do parâmetro path permitem especificar várias geometrias com seus estilos. O número de parâmetros por solicitação é limitado a 10 e o número de locais é limitado a 100 por caminho.
Para renderizar um círculo com raio de 100 metros e ponto central na latitude 45°N e longitude 122°W usando o estilo padrão, adicione o parâmetro querystring
path=ra100||-122 45
Observe que a longitude vem antes da latitude. Após a codificação de URL, essa aparência será semelhante a
path=ra100%7C%7C-122+45
Todos os exemplos aqui mostram o parâmetro path sem codificação de URL, para maior clareza.
Para renderizar uma linha, separe cada local com um caractere de pipe. Por exemplo, use
path=||-122 45|-119.5 43.2|-121.67 47.12
Para renderizar um polígono, o último local deve ser igual ao local inicial. Por exemplo, use
path=||-122 45|-119.5 43.2|-121.67 47.12|-122 45
Os valores de longitude e latitude para locais de linhas e polígonos podem estar no intervalo de -360 a 360 para permitir a renderização de geometrias que cruzam o anti-meridiano.
Modificadores de estilo
Você pode modificar a aparência do caminho adicionando modificadores de estilo. Eles são adicionados antes dos locais. Cada um dos modificadores de estilo tem um nome de duas letras. Esses nomes abreviados são usados para ajudar a reduzir o comprimento da URL.
Para alterar a cor da estrutura de tópicos, use o modificador de estilo 'lc' e especifique a cor usando o formato de cor HTML/CSS RGB, que é um número hexadecimal de seis dígitos (não há suporte para a forma de três dígitos). Por exemplo, para usar uma cor rosa profunda que você especificaria como #FF1493 no CSS, use
path=lcFF1493||-122 45|-119.5 43.2
Vários modificadores de estilo podem ser combinados 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
Obtendo locais de caminho do armazenamento de dados Azure Mapas
Para todos os SKUs de conta Azure Mapas que não sejam S0, as informações de localização do caminho podem ser obtidas de Azure Mapas Armazenamento de Dados. Depois de carregar um documento GeoJSON que contém locais de caminho, o serviço armazenamento de dados retorna uma UDID (ID de Dados Exclusiva) que você pode usar para fazer referência aos dados no parâmetro path.
Para usar a geometria de ponto de um documento GeoJSON carregado como os locais do caminho, especifique a UDID na seção locais do parâmetro path. Por exemplo,
path=||udid-29dc105a-dee7-409f-a3f9-22b066ae4713
Observe que não é permitido misturar locais de caminho do Armazenamento de Dados com locais especificados no parâmetro path.
Resumo do modificador de estilo
Modificador | Descrição | Intervalo |
---|---|---|
Lc | Cor da linha | 000000 a FFFFFF |
fc | Cor de preenchimento | 000000 a FFFFFF |
la | Linha alfa (opacidade) | 0 a 1 |
fa | Preenchimento alfa (opacidade) | 0 a 1 |
Lw | Largura da linha | Maior que 0 |
Ra | Raio do círculo (metros) | Maior que 0 |
path?: string[]
Valor da propriedade
string[]
pins
Estilo de pino e instâncias. Use esse parâmetro para, opcionalmente, adicionar pinos à imagem. O estilo de pino descreve a aparência dos pinos e as instâncias especificam as coordenadas dos pinos e rótulos opcionais para cada pino. (Certifique-se de codificar corretamente valores de URL desse parâmetro, pois ele conterá caracteres reservados, como pipes e pontuação.) O SKU S0 da conta Azure Mapas dá suporte apenas a uma única instância do parâmetro pins. Outras SKUs permitem que várias instâncias do parâmetro pins especifiquem vários estilos de pin.
Para renderizar um pino em latitude 45°N e longitude 122°W usando o estilo de pino interno padrão, adicione o parâmetro querystring
pins=default||-122 45
Observe que a longitude vem antes da latitude. Após a codificação de URL, essa aparência 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 renderizar um pino em vários locais, separe cada local com um caractere de pipe. Por exemplo, use
pins=default||-122 45|-119.5 43.2|-121.67 47.12
O SKU da conta de Azure Mapas S0 permite apenas cinco pinos. Outras SKUs de conta não têm essa limitação.
Modificadores de estilo
É possível modificar a aparência dos pinos adicionando modificadores de estilo. Eles são adicionados após o estilo, mas antes dos locais e rótulos. Cada um dos modificadores de estilo tem um nome de duas letras. Esses nomes abreviados são usados para ajudar a reduzir o comprimento da URL.
Para alterar a cor do pino, use o modificador de estilo 'co' e especifique a cor usando o formato de cor HTML/CSS RGB, que é um número hexadecimal de seis dígitos (não há suporte para a forma de três dígitos). Por exemplo, para usar uma cor rosa profunda que você especificaria como #FF1493 no CSS, use
pins=default|coFF1493||-122 45
Rótulos de pino
Para adicionar um rótulo aos pinos, coloque o rótulo entre aspas simples pouco antes das coordenadas. Por exemplo, para rotular três pinos com os valores '1', '2' e '3', use
pins=default||'1'-122 45|'2'-119.5 43.2|'3'-121.67 47.12
Há um estilo de pino interno chamado 'none' que não exibe uma imagem de pino. Você pode usar isso se quiser exibir rótulos sem nenhuma imagem de fixação. Por exemplo,
pins=none||'A'-122 45|'B'-119.5 43.2
Para alterar a cor dos rótulos de pino, use o modificador de estilo de cor do rótulo 'lc'. Por exemplo, para usar pinos rosa com rótulos pretos, use
pins=default|coFF1493|lc000000||-122 45
Para alterar o tamanho dos rótulos, use o modificador de estilo de tamanho de rótulo 'ls'. O tamanho do rótulo representa a altura aproximada do texto do rótulo em pixels. Por exemplo, para aumentar o tamanho do rótulo para 12, use
pins=default|ls12||'A'-122 45|'B'-119 43
Os rótulos são centralizados no pushpin 'label anchor'. O local da âncora é predefinido para pinos internos e está no centro superior de pinos personalizados (veja abaixo). Para substituir a âncora de rótulo, use o modificador de estilo 'la' e forneça coordenadas de pixel X e Y para a âncora. Essas coordenadas são relativas ao canto superior esquerdo da imagem de pino. Os valores positivos X movem a âncora para a direita e os valores Y positivos movem a âncora para baixo. Por exemplo, para posicionar a âncora de rótulo 10 pixels para a direita e 4 pixels acima do canto superior esquerdo da imagem de pino, use
pins=default|la10 -4||'A'-122 45|'B'-119 43
Pinos personalizados
Para usar uma imagem de pushpin personalizada, use a palavra "personalizado" como o nome do estilo do pino e especifique uma URL após as informações de localização e rótulo. Use dois caracteres de pipe para indicar que você terminou de especificar locais e está iniciando a URL. Por exemplo,
pins=custom||-122 45||http://contoso.com/pushpins/red.png
Após a codificação de URL, isso teria a aparência
pins=custom%7C%7C-122+45%7C%7Chttp%3A%2F%2Fcontoso.com%2Fpushpins%2Fred.png
Por padrão, as imagens de pino personalizadas são desenhadas centralizada nas coordenadas do pino. Isso geralmente não é ideal, pois obscurece o local que você está tentando realçar. Para substituir o local de âncora da imagem de pino, use o modificador de estilo 'an'. Isso usa o mesmo formato que o modificador de estilo de âncora de rótulo 'la'. Por exemplo, se sua imagem de fixação personalizada tiver a ponta do pino no canto superior esquerdo da imagem, você poderá definir a âncora para esse ponto usando
pins=custom|an0 0||-122 45||http://contoso.com/pushpins/red.png
Observação: se você usar o modificador de cor 'co' com uma imagem de pino personalizada, a cor especificada substituirá os canais RGB dos pixels na imagem, mas deixará o canal alfa (opacidade) inalterado. Isso normalmente só seria feito com uma imagem personalizada de cor sólida.
Obtendo pushpins do armazenamento de dados Azure Mapas
Para todos os SKUs de conta Azure Mapas que não sejam S0, as informações de localização e imagem de pushpin podem ser obtidas de Azure Mapas Armazenamento de Dados. Depois de carregar uma imagem de pushpin ou um documento GeoJSON que contém locais de pino, o serviço armazenamento de dados retorna uma ID de Dados Exclusiva (UDID) que você pode usar para referenciar os dados no parâmetro pins.
Para usar uma imagem de pushpin personalizada do armazenamento de dados Azure Mapas, especifique o UDID prefixado por 'udid-' como o nome do estilo de pino. Por exemplo,
pins=udid-fe22c504-3a81-4fcd-adc6-a3507ce866c1||-122 45
Para usar a geometria de ponto de um documento GeoJSON carregado como locais de fixação, especifique a UDID na seção locais do parâmetro pins. Por exemplo,
pins=default||udid-29dc105a-dee7-409f-a3f9-22b066ae4713
Observe que somente geometria de ponto e multiponto, pontos e vários pontos de coleções de geometria e geometria de ponto dos recursos serão usados. A linhagem e a geometria do polígono serão ignoradas. Se o ponto for proveniente de um recurso e o recurso tiver uma propriedade de cadeia de caracteres chamada "label", o valor dessa propriedade será usado como o rótulo do pino.
Você pode misturar locais de fixação do Armazenamento de Dados e fixar locais especificados no parâmetro pins. Qualquer um dos locais de pino delimitados por pipe pode ser uma longitude e latitude ou um UDID. Por exemplo,
pins=default||-122 45|udid-29dc105a-dee7-409f-a3f9-22b066ae4713|-119 43
Escala, rotação e opacidade
É possível criar pinos e rótulos maiores ou menores, usando o modificador de estilo de escala 'sc'. Esse é um valor maior que zero. Um valor de 1 é a escala padrão. Valores maiores que 1 tornarão os marcadores maiores e valores menores que 1 os tornarão menores. Por exemplo, para desenhar os pinos 50% maiores que o normal, use
pins=default|sc1.5||-122 45
Você pode girar os pinos e seus rótulos usando o modificador de estilo de rotação 'ro'. Esse é um número de graus de rotação no sentido horário. Use um número negativo para girar no sentido anti-horário. Por exemplo, para girar os pinos 90 graus no sentido horário e dobrar seu tamanho, use
pins=default|ro90|sc2||-122 45
Você pode tornar os pinos e seus rótulos parcialmente transparentes especificando o modificador de estilo alfa 'al'. Esse é um número entre 0 e 1 que indica a opacidade dos pinos. Zero os torna completamente transparentes (e não visíveis) e 1 os torna completamente opacos (que é o padrão). Por exemplo, para tornar os pinos e seus rótulos apenas 67% opacos, use
pins=default|al.67||-122 45
Resumo do modificador de estilo
Modificador | Descrição | Intervalo |
---|---|---|
al | Alfa (opacidade) | 0 a 1 |
an | Fixar âncora | * |
co | Cor do pino | 000000 a FFFFFF |
la | Âncora de rótulo | * |
Lc | Cor do rótulo | 000000 a FFFFFF |
ls | Tamanho do rótulo | 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 pino ou uma margem ao redor dela. O tamanho da margem é o mínimo da largura e altura do pino.
pins?: string[]
Valor da propriedade
string[]
style
Estilo de mapa a ser retornado. Atualmente, somente o estilo disponível é main. Os valores possíveis incluem: 'main'
style?: Style
Valor da propriedade
view
O parâmetro View especifica qual conjunto de conteúdo geopoliticamente disputado é retornado por meio de serviços de Azure Mapas, incluindo bordas e rótulos exibidos no mapa. O parâmetro View (também conhecido como "parâmetro de região do usuário") mostrará os mapas corretos para esse país/região. Por padrão, o parâmetro View é definido como "Unificado", mesmo que você não o tenha definido na solicitação. É sua responsabilidade determinar a localização de seus usuários e, em seguida, definir o parâmetro View corretamente para esse local. Como alternativa, você tem a opção de definir 'View=Auto', que retornará os dados do mapa com base no endereço IP da solicitação. O parâmetro View no Azure Mapas deve ser usado em conformidade com as leis aplicáveis, incluindo aquelas relativas ao mapeamento, do país em que são disponibilizados mapas, imagens e outros dados e conteúdo de terceiros que você está autorizado a acessar por meio de Azure Mapas. Exemplo: view=IN. Consulte Modos de exibição com suporte para obter detalhes e para ver as Exibições disponíveis.
view?: string
Valor da propriedade
string
width
Largura da imagem resultante em pixels. O intervalo é de 1 a 8192. O padrão é 512. Ele não deve ser usado com bbox.
width?: number
Valor da propriedade
number
zoom
Nível de zoom desejado do mapa. O valor de zoom deve estar no intervalo: 0 a 20 (inclusive). O valor padrão é 12.
Confira Níveis de Zoom e Grade de Blocos para obter detalhes.
zoom?: number
Valor da propriedade
number
Detalhes das propriedades herdadas
abortSignal
O sinal que pode ser usado para anular solicitações.
abortSignal?: AbortSignalLike
Valor da propriedade
AbortSignalLike
Herdado de RequestOptionsBase.abortSignal
customHeaders
{object} [customHeaders] Cabeçalhos de solicitação personalizados definidos pelo usuário que serão aplicados antes do envio da solicitação.
customHeaders?: [key: string]: string
Valor da propriedade
[key: string]: string
Herdado de RequestOptionsBase.customHeaders
onDownloadProgress
Retorno de chamada que é disparado após o progresso do download.
onDownloadProgress?: (progress: TransferProgressEvent) => void
Valor da propriedade
(progress: TransferProgressEvent) => void
Herdado de RequestOptionsBase.onDownloadProgress
onUploadProgress
Retorno de chamada que é disparado após o progresso do upload.
onUploadProgress?: (progress: TransferProgressEvent) => void
Valor da propriedade
(progress: TransferProgressEvent) => void
Herdado de RequestOptionsBase.onUploadProgress
timeout
O número de milissegundos que uma solicitação pode levar antes de ser encerrada automaticamente.
timeout?: number
Valor da propriedade
number
Herdado de RequestOptionsBase.timeout