Render - Get Map Static Image

Serviço:

Maps

Versão da API:

2024-04-01

Esta API de composição produz vistas de mapa estáticas e rasterizadas de uma área definida pelo utilizador. É adequado para aplicações Web leves, quando a experiência de utilizador pretendida não requer controlos de mapa interativos ou quando a largura de banda é limitada. Esta API também é útil para incorporar mapas em aplicações fora do browser, em serviços de back-end, geração de relatórios ou aplicações de ambiente de trabalho.

Esta API inclui parâmetros para visualização de dados básicos:

• Pushpins etiquetados em múltiplos estilos.
• Compor tipos de geometria de círculo, caminho e polígono.

Para obter mais informações e exemplos detalhados, veja Compor dados personalizados num mapa raster.

As dimensões do parâmetro bbox são restritas, dependendo do nível de zoom. Isto garante que a imagem resultante tem um nível de detalhe adequado.

Nível de Zoom	Intervalo Mínimo de Lon	Intervalo Máximo de Lon	Intervalo mínimo de Lat	Intervalo Máximo de Lat
0	56.25	360.0	30.1105585173	180.0
1	28.125	360.0	14.87468995	180.0
2	14.063	351.5625	7.4130741851	137.9576312246
3	7.03125	175.78125	3.7034501005	73.6354071932
4	3.515625	87.890625	1.8513375155	35.4776115315
5	1.7578125	43.9453125	0.925620264	17.4589959239
6	0.87890625	21.97265625	0.4628040687	8.6907788223
7	0.439453125	10.986328125	0.2314012764	4.3404320789
8	0.2197265625	5.4931640625	0.1157005434	2.1695927024
9	0.1098632812	2.7465820312	0.0578502599	1.0847183194
10	0.0549316406	1.3732910156	0.0289251285	0.5423494021
11	0.0274658203	0.6866455078	0.014462564	0.2711734813
12	0.0137329102	0.3433227539	0.007231282	0.1355865882
13	0.0068664551	0.171661377	0.003615641	0.067793275
14	0.0034332275	0.0858306885	0.0018078205	0.0338966351
15	0.0017166138	0.0429153442	0.0009039102	0.0169483173
16	0.0008583069	0.0214576721	0.0004519551	0.0084741586
17	0.0004291534	0.0107288361	0.0002259776	0.0042370793
18	0.0002145767	0.005364418	0.0001129888	0.0021185396
19	0.0001072884	0.002682209	5.64944E-05	0.0010592698
20	5.36442E-05	0.0013411045	2.82472E-05	0.0005296349

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

GET https://atlas.microsoft.com/map/static?api-version=2024-04-01

Com parâmetros opcionais:

GET https://atlas.microsoft.com/map/static?api-version=2024-04-01&tilesetId={tilesetId}&trafficLayer={trafficLayer}&zoom={zoom}&center={center}&bbox={bbox}&height={height}&width={width}&language={language}&view={view}&pins={pins}&path={path}

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
api-version	query	True	string	Número da versão da API do Azure Maps. A versão atual é 2024-04-01.
bbox	query		number[]	Uma caixa delimitadora é definida por duas latitudes e duas longitudes que representam os quatro lados de uma área retangular na Terra. Formato: "minLon, minLat, maxLon, maxLat" (em duplo). Nota: o bbox ou o centro são parâmetros necessários. São mutuamente exclusivos. O bbox não deve ser utilizado com altura ou largura. Os intervalos máximos e mínimos permitidos para Lat e Lon são definidos para cada nível de zoom na tabela na parte superior desta página.
center	query		number[]	Coordenadas do ponto central em duplo. Formato: "lon,lat". Intervalo de longitude: -180 a 180. Intervalo de latitude: -90 a 90. Nota: o centro ou o bbox são parâmetros necessários. São mutuamente exclusivos.
height	query		integer int32	Altura da imagem resultante em píxeis. Intervalo entre 80 e 1500. A predefinição é 512. Não deve ser utilizado com bbox.
language	query		string	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.
path	query		string[]	Estilo de caminho e localizações (em duplo). Utilize este parâmetro para adicionar opcionalmente linhas, polígonos ou círculos à imagem. O estilo de caminho descreve o aspeto da linha e o preenchimento. (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 parâmetro path é suportado no SKU da conta do Azure Maps a partir do S1. Várias instâncias do parâmetro de caminho permitem especificar múltiplas 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, será semelhante a path=ra100%7C%7C-122+45 Todos os exemplos aqui mostram o parâmetro de caminho 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 Um polígono é especificado com um caminho fechado, em que os primeiros e últimos pontos são iguais. Por exemplo, utilize path=||-122 45|-119.5 43.2|-121.67 47.12|-122 45 O valor de longitude para localizações de linhas e polígonos pode 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. Estas são adicionadas 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 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 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 Resumo do Modificador de Estilos Modificador Descrição Tipo Intervalo lc Cor da linha string 0000000 para FFFFFF fc Cor de preenchimento string 0000000 para FFFFFF la Alfa de linha (opacidade) float 0 a 1 fa Preenchimento alfa (opacidade) float 0 a 1 lw Largura da linha int32 (0, 50] ra Raio circular (medidores) float Maior que 0
pins	query		string[]	Estilo e instâncias pushpin. Utilize este parâmetro para, opcionalmente, adicionar pushpins à imagem. O estilo pushpin descreve o aspeto dos pinos pushpin e as instâncias especificam as coordenadas dos pinos pushpins (em duplo) e as etiquetas opcionais para cada pino. (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 SKU S0 da conta do Azure Maps suporta apenas uma única instância do parâmetro 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 alfinete 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, terá o seguinte aspeto pins=default%7C%7C-122+45 Todos os exemplos aqui apresentados mostram o parâmetro pins sem codificação de URL, para maior clareza. Para compor um marcador 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 do 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 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 pins=default|coFF1493||-122 45 Etiquetas pushpin Para adicionar uma etiqueta aos pinos, coloque a etiqueta entre plicas imediatamente antes das coordenadas. Evite utilizar carateres especiais, como | ou || na etiqueta. 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 pushpin incorporado chamado "nenhum" que não apresenta uma imagem pushpin. Pode utilizar esta opção se pretender 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 alfinetes 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 pixéis. 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 pinos incorporados e está no centro superior dos pinos personalizados (ver abaixo). Para substituir a âncora de etiquetas, utilize o modificador de estilo "la" e forneça coordenadas de píxeis 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 etiqueta 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 Alfinetes Personalizados Para utilizar uma imagem pushpin personalizada, utilize a palavra "personalizado" como o nome do estilo do pino e, em seguida, especifique um URL após as informações de localização e etiqueta. O tamanho máximo permitido para uma imagem de etiqueta personalizada é de 65 536 píxeis. Utilize dois carateres de pipe para indicar que concluiu a especificação de 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. 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 Descrição Tipo Intervalo al Alfa (opacidade) float 0 a 1 mar Afixar âncora <int32, int32> * co Afixar cor string 0000000 para FFFFFF la Âncora de etiquetas <int32, int32> * lc Cor da etiqueta string 0000000 para FFFFFF ls Tamanho da etiqueta float Maior que 0 ro Rotação float -360 a 360 sc Escala float 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.
tilesetId	query		TilesetId	Estilo de mapa a ser devolvido. Os valores possíveis são microsoft.base.road, microsoft.base.darkgrey e microsoft.imagery. O valor predefinido está definido como microsoft.base.road. Para obter mais informações, veja Render TilesetId.
trafficLayer	query		TrafficTilesetId	Valor Opcional, que indica que não existe um fluxo de tráfego sobreposto no resultado da imagem. Os valores possíveis são microsoft.traffic.relative.main e nenhum. O valor predefinido não é nenhum, o que indica que não foi devolvido nenhum fluxo de tráfego. Se for fornecido tilesetId relacionado com o tráfego, devolverá a imagem do mapa com a camada de tráfego correspondente. Para obter mais informações, veja Render TilesetId.
view	query		LocalizedMapView	O parâmetro Ver (também denominado parâmetro "região do utilizador") permite-lhe mostrar os mapas corretos para um determinado país/região para regiões geopolíticos disputadas. Diferentes países/regiões têm vistas diferentes dessas regiões e o parâmetro Ver permite que a sua aplicação cumpra a vista exigida pelo país/região que a sua aplicação irá servir. 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 irá 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/região onde são disponibilizados mapas, imagens e outros dados e conteúdos de terceiros aos quais está autorizado a aceder através do Azure Maps. Exemplo: view=IN. Consulte As Vistas Suportadas para obter detalhes e ver as Vistas disponíveis.
width	query		integer int32	Largura da imagem resultante em píxeis. De 80 a 2000. A predefinição é 512. Não deve ser utilizado com bbox.
zoom	query		integer int32	Nível de zoom pretendido do mapa. O valor do zoom de suporte varia entre 0 e 20 (inclusive) para tilesetId sendo microsoft.base.road ou microsoft.base.darkgrey. Suporte para o intervalo de valores de zoom de 0 a 19 (inclusive) para tilesetId sendo microsoft.imagery. O valor predefinido é 12. Para obter mais informações, veja Níveis de Zoom e Grelha de Mosaicos.

Cabeçalho do Pedido

Name	Necessário	Tipo	Description
x-ms-client-id		string	Especifica a conta que se destina à utilização em conjunto com o modelo de segurança Microsoft Entra ID. Representa um ID exclusivo para a conta do Azure Maps e pode ser obtido a partir da API de Conta do plano de gestão do Azure Maps. Para utilizar a segurança do Microsoft Entra ID no Azure Maps, consulte os seguintes artigos para obter orientações.
Accept		MediaType	O campo Aceitar cabeçalho pode ser utilizado para especificar preferências relativas a tipos de suporte de dados de resposta. Os tipos de multimédia permitidos incluem imagem/jpeg e imagem/png. Devolver imagem na imagem/png se o cabeçalho Aceitar não for especificado.

Respostas

Name	Tipo	Description
200 OK	object	Esta imagem é devolvida a partir de uma chamada Obter Imagem Estática de Mapa com êxito. Media Types: "image/jpeg", "image/png" Cabeçalhos Content-Type: string
Other Status Codes	ErrorResponse	Ocorreu um erro inesperado. Media Types: "image/jpeg", "image/png"

Segurança

AADToken

Estes são os Fluxos microsoft Entra OAuth 2.0 . Quando emparelhado com o controlo de acesso baseado em funções do Azure , pode ser utilizado para controlar o acesso às APIs REST do Azure Maps. Os controlos de acesso baseados em funções do Azure são utilizados para designar o acesso a uma ou mais contas de recursos ou sub-recursos do Azure Maps. Qualquer utilizador, grupo ou principal de serviço pode ter acesso através de uma função incorporada ou de uma função personalizada composta por uma ou mais permissões para as APIs REST do Azure Maps.

Para implementar cenários, recomendamos que veja os conceitos de autenticação. Em resumo, esta definição de segurança fornece uma solução para modelar aplicações através de objetos com capacidade de controlo de acesso em APIs e âmbitos específicos.

Notas

• Esta definição de segurança requer a utilização do x-ms-client-id cabeçalho para indicar a que recurso do Azure Maps a aplicação está a pedir acesso. Isto pode ser adquirido na API de gestão de Mapas.

O Authorization URL é específico da instância da cloud pública do Azure. As clouds soberanas têm URLs de Autorização exclusivos e configurações do Microsoft Entra ID. * O controlo de acesso baseado em funções do Azure está configurado a partir do plano de gestão do Azure através do portal do Azure, do PowerShell, da CLI, dos SDKs do Azure ou das APIs REST. * A utilização do SDK Web do Azure Maps permite a configuração baseada na configuração de uma aplicação para vários casos de utilização.

• Para obter mais informações sobre a plataforma de identidades da Microsoft, consulte Descrição geral da plataforma de identidades da Microsoft.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
https://atlas.microsoft.com/.default	https://atlas.microsoft.com/.default

subscription-key

Esta é uma chave partilhada que é aprovisionada ao criar um recurso do Azure Maps através do plano de gestão do Azure através do portal do Azure, do PowerShell, da CLI, dos SDKs do Azure ou das APIs REST.

Com esta chave, qualquer aplicação está autorizada a aceder a todas as APIs REST. Por outras palavras, estas podem atualmente ser tratadas como chaves mestras da conta para a qual são emitidas.

Para aplicações expostas publicamente, a nossa recomendação é utilizar o acesso servidor a servidor das APIs REST do Azure Maps, onde esta chave pode ser armazenada de forma segura.

Tipo: apiKey
Em: header

SAS Token

Este é um token de assinatura de acesso partilhado criado a partir da operação List SAS no recurso do Azure Maps através do plano de gestão do Azure através do portal do Azure, do PowerShell, da CLI, dos SDKs do Azure ou das APIs REST.

Com este token, qualquer aplicação está autorizada a aceder com controlos de acesso baseados em funções do Azure e controlo detalhado para a expiração, taxa e regiões de utilização para o token específico. Por outras palavras, o Token de SAS pode ser utilizado para permitir que as aplicações controlem o acesso de uma forma mais segura do que a chave partilhada.

Para aplicações expostas publicamente, a nossa recomendação é configurar uma lista específica de origens permitidas no recurso da conta de Mapa para limitar o abuso de composição e renovar regularmente o Token de SAS.

Tipo: apiKey
Em: header

Exemplos

Successful Static Image Request

Pedido de amostra

HTTP

GET https://atlas.microsoft.com/map/static?api-version=2024-04-01&tilesetId=microsoft.base.road&zoom=10&center=-122.177621,47.613079

Resposta da amostra

Código de estado:

200

Content-Type: image/png

"{file}"

Definições

Name	Description
ErrorAdditionalInfo	Informações adicionais sobre o erro de gestão de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta a erros
LocalizedMapView	O parâmetro Ver (também denominado parâmetro "região do utilizador") permite-lhe mostrar os mapas corretos para um determinado país/região para regiões geopolíticos disputadas. Diferentes países/regiões têm vistas diferentes dessas regiões e o parâmetro Ver permite que a sua aplicação cumpra a vista exigida pelo país/região que a sua aplicação irá servir. 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/região onde são disponibilizados mapas, imagens e outros dados e conteúdos de terceiros aos quais está autorizado a aceder através do Azure Maps. Exemplo: view=IN. Consulte Vistas Suportadas para obter detalhes e para ver as Vistas disponíveis.
MediaType	O campo Aceitar cabeçalho pode ser utilizado para especificar preferências relativas a tipos de suporte de dados de resposta. Os tipos de multimédia permitidos incluem imagem/jpeg e imagem/png. Devolver imagem na imagem/png se o cabeçalho Aceitar não for especificado.
TilesetId	Estilo de mapa a devolver. Os valores possíveis são microsoft.base.road, microsoft.base.darkgrey e microsoft.imagery. O valor predefinido está definido como microsoft.base.road. Para obter mais informações, veja Render TilesetId.
TrafficTilesetId	Valor Opcional, que indica que não existe nenhum fluxo de tráfego sobreposto no resultado da imagem. Os valores possíveis são microsoft.traffic.relative.main e nenhum. O valor predefinido não é nenhum, indicando que não foi devolvido nenhum fluxo de tráfego. Se for fornecido o tilesetId relacionado com o tráfego, devolverá a imagem do mapa com a camada de tráfego correspondente. Para obter mais informações, veja Render TilesetId.

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

Name	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Name	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Resposta a erros

Name	Tipo	Description
error	ErrorDetail	O objeto de erro.

LocalizedMapView

O parâmetro Ver (também denominado parâmetro "região do utilizador") permite-lhe mostrar os mapas corretos para um determinado país/região para regiões geopolíticos disputadas. Diferentes países/regiões têm vistas diferentes dessas regiões e o parâmetro Ver permite que a sua aplicação cumpra a vista exigida pelo país/região que a sua aplicação irá servir. 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/região onde são disponibilizados mapas, imagens e outros dados e conteúdos de terceiros aos quais está autorizado a aceder através do Azure Maps. Exemplo: view=IN.

Consulte Vistas Suportadas para obter detalhes e para ver as Vistas disponíveis.

Name	Tipo	Description
AE	string	Emirados Árabes Unidos (Vista Árabe)
AR	string	Argentina (Vista Argentina)
Auto	string	Devolva os dados do mapa com base no endereço IP do pedido.
BH	string	Bahrein (Vista Árabe)
IN	string	Índia (Vista Indiana)
IQ	string	Iraque (Vista Árabe)
JO	string	Jordânia (Vista Árabe)
KW	string	Kuwait (Vista Árabe)
LB	string	Líbano (Vista Árabe)
MA	string	Marrocos (Vista Marroquina)
OM	string	Omã (Vista Árabe)
PK	string	Paquistão (Vista Paquistanesa)
PS	string	Autoridade Palestiniana (Vista Árabe)
QA	string	Qatar (Vista Árabe)
SA	string	Arábia Saudita (Vista Árabe)
SY	string	Síria (Vista Árabe)
Unified	string	Vista Unificada (Outros)
YE	string	Iémen (Vista Árabe)

MediaType

O campo Aceitar cabeçalho pode ser utilizado para especificar preferências relativas a tipos de suporte de dados de resposta. Os tipos de multimédia permitidos incluem imagem/jpeg e imagem/png. Devolver imagem na imagem/png se o cabeçalho Aceitar não for especificado.

Name	Tipo	Description
image/jpeg	string	Devolver imagem no formato jpeg.
image/png	string	Devolver imagem no formato png.

TilesetId

Estilo de mapa a devolver. Os valores possíveis são microsoft.base.road, microsoft.base.darkgrey e microsoft.imagery. O valor predefinido está definido como microsoft.base.road. Para obter mais informações, veja Render TilesetId.

Name	Tipo	Description
microsoft.base.darkgrey	string	TilesetId contém todas as camadas com o nosso estilo cinzento escuro.
microsoft.base.road	string	TilesetId contém todas as camadas com o estilo principal de composição.
microsoft.imagery	string	TilesetId contém uma combinação de imagens de satélite e aéreas.

TrafficTilesetId

Valor Opcional, que indica que não existe nenhum fluxo de tráfego sobreposto no resultado da imagem. Os valores possíveis são microsoft.traffic.relative.main e nenhum. O valor predefinido não é nenhum, indicando que não foi devolvido nenhum fluxo de tráfego. Se for fornecido o tilesetId relacionado com o tráfego, devolverá a imagem do mapa com a camada de tráfego correspondente. Para obter mais informações, veja Render TilesetId.

Name	Tipo	Description
microsoft.traffic.relative.main	string	TilesetId relacionado com o tráfego suportado.
none	string	Valor predefinido, sem sobreposição de fluxo de tráfego.