Compartilhar via


Render - Get Map Static Image

Essa API de renderização produz exibições de mapa estáticas e rasterizadas de uma área definida pelo usuário. Ele é adequado para aplicativos Web leves, quando a experiência de usuário desejada não requer controles de mapa interativos ou quando a largura de banda é limitada. Essa API também é útil para inserir mapas em aplicativos fora do navegador, em serviços de back-end, geração de relatórios ou aplicativos da área de trabalho.

Essa API inclui parâmetros para visualização de dados básica:

  • Pinos rotulados em vários estilos.
  • Renderizar tipos de geometria de círculo, caminho e polígono.

Para obter mais informações e exemplos detalhados, consulte Renderizar dados personalizados em um mapa de raster.

As dimensões do parâmetro bbox são restritas, dependendo do nível de zoom. Isso garante que a imagem resultante tenha um nível apropriado de detalhes.

Nível de zoom Intervalo de Lon Mínimo Intervalo máximo de lon Intervalo De Lat Mínimo 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

Observação : o parâmetro central ou bbox deve ser fornecido à API.

GET https://atlas.microsoft.com/map/static?api-version=2024-04-01
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 de URI

Nome Em Obrigatório Tipo Description
api-version
query True

string

Número de versão da API de Mapas Azure. 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).

Observação: bbox ou central são parâmetros necessários. Eles são mutuamente exclusivos. bbox não deve ser usado com altura ou largura.

Os intervalos máximo e mínimo 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.

Observação: os parâmetros central ou bbox são necessários. Eles são mutuamente exclusivos.

height
query

integer

int32

Altura da imagem resultante em pixels. Intervalo de 80 a 1500. O padrão é 512. Ele não deve ser usado com bbox.

language
query

string

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.

path
query

string[]

Estilo de caminho e locais (em duplo). 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 do Azure Mapas a partir do 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, isso terá a aparência

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

Um polígono é especificado com um caminho fechado, em que o primeiro e o último pontos são iguais. Por exemplo, use

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

O valor de longitude para locais de linhas e polígonos pode 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 RGB HTML/CSS, 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

Resumo do modificador de estilo

Modificador Descrição Tipo Intervalo
Lc Cor da linha string 000000 a FFFFFF
fc Cor de preenchimento string 000000 a FFFFFF
la Linha alfa (opacidade) FLOAT 0 a 1
fa Preenchimento alfa (opacidade) FLOAT 0 a 1
Lw Largura da linha int32 (0, 50]
Ra Raio do círculo (medidores) FLOAT Maior que 0
pins
query

string[]

Estilo de pino e instâncias. Use esse parâmetro para, opcionalmente, adicionar pinos à imagem. O estilo pushpin descreve a aparência dos pinos e as instâncias especificam as coordenadas dos pinos (em duplo) 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 do 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 do S0 Azure Mapas 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. Evite usar caracteres especiais, como | ou || no rótulo. 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. O tamanho máximo permitido para uma imagem de rótulo personalizada é de 65.536 pixels. 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 seria parecido com

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 a imagem de pino 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.

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 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 Tipo Intervalo
al Alfa (opacidade) FLOAT 0 a 1
an Fixar âncora <int32, int32> *
co Cor do pino string 000000 a FFFFFF
la Âncora de rótulo <int32, int32> *
Lc Cor do rótulo string 000000 a FFFFFF
ls Tamanho do rótulo 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 pino ou uma margem ao redor dela. O tamanho da margem é o mínimo da largura e altura do pino.
tilesetId
query

TilesetId

Estilo de mapa a ser retornado. Os valores possíveis são microsoft.base.road, microsoft.base.darkgrey e microsoft.imagery. O valor padrão é definido como microsoft.base.road. Para obter mais informações, consulte Renderizar TilesetId.

trafficLayer
query

TrafficTilesetId

Valor opcional, indicando que nenhum fluxo de tráfego sobreposto ao resultado da imagem. Os valores possíveis são microsoft.traffic.relative.main e nenhum. O valor padrão é nenhum, indicando que nenhum fluxo de tráfego retornado. Se tilesetId relacionado ao tráfego for fornecido, retornará a imagem do mapa com a camada de tráfego correspondente. Para obter mais informações, consulte Renderizar TilesetId.

view
query

LocalizedMapView

O parâmetro View (também chamado de parâmetro "região do usuário") permite mostrar os mapas corretos para um determinado país/região para regiões geopolíticas disputadas. Diferentes países/regiões têm diferentes exibições dessas regiões e o parâmetro View permite que seu aplicativo cumpra a exibição exigida pelo país/região que seu aplicativo atenderá. 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/região em que são disponibilizados mapas, imagens e outros dados e conteúdo de terceiros que você está autorizado a acessar por meio do Azure Mapas. Exemplo: view=IN.

Consulte Modos de exibição com suporte para obter detalhes e para ver as Exibições disponíveis.

width
query

integer

int32

Largura da imagem resultante em pixels. Intervalo de 80 a 2000. O padrão é 512. Ele não deve ser usado com bbox.

zoom
query

integer

int32

Nível de zoom desejado do mapa. O valor de zoom de suporte varia de 0 a 20 (inclusivo) para tilesetId sendo microsoft.base.road ou microsoft.base.darkgrey. O valor de zoom de suporte varia de 0 a 19 (inclusivo) para tilesetId sendo microsoft.imagery. O valor padrão é 12.

Para obter mais informações, consulte Níveis de zoom e grade de blocos.

Cabeçalho da solicitação

Nome Obrigatório Tipo Description
x-ms-client-id

string

Especifica qual conta destina-se ao uso em conjunto com o modelo de segurança da ID do Microsoft Entra. Ele representa uma ID exclusiva para a conta do Azure Mapas e pode ser recuperado da API de Conta do plano de gerenciamento do Azure Mapas. Para usar a segurança do Microsoft Entra ID no Azure Mapas, confira os artigos a seguir para obter diretrizes .

Accept

MediaType

O campo Aceitar cabeçalho pode ser usado para especificar preferências relacionadas aos tipos de mídia de resposta. Os tipos de mídia permitidos incluem image/jpeg e image/png. Retornar imagem em image/png se Accept header não for especificado.

Respostas

Nome Tipo Description
200 OK

object

Essa imagem é retornada de uma chamada bem-sucedida Obter Imagem Estática do Mapa.

Media Types: "image/jpeg", "image/png"

Cabeçalhos

Content-Type: string

Other Status Codes

ErrorResponse

Erro inesperado.

Media Types: "image/jpeg", "image/png"

Segurança

AADToken

Estes são os Fluxos do Microsoft Entra OAuth 2.0 . Quando emparelhado com o controle de acesso baseado em função do Azure , ele pode ser usado para controlar o acesso às APIs REST do Azure Mapas. Os controles de acesso baseados em função do Azure são usados para designar o acesso a uma ou mais sub-recursos ou conta de recurso do Azure Mapas. Qualquer usuário, grupo ou entidade de serviço pode receber acesso por meio de uma função interna ou uma função personalizada composta por uma ou mais permissões para APIs REST do Azure Mapas.

Para implementar cenários, recomendamos exibir conceitos de autenticação. Em resumo, essa definição de segurança fornece uma solução para modelar aplicativos por meio de objetos capazes de acessar o controle em APIs e escopos específicos.

Observações

  • Essa definição de segurança requer o uso do x-ms-client-id cabeçalho para indicar a qual recurso do Azure Mapas o aplicativo está solicitando acesso. Isso pode ser adquirido da API de gerenciamento de Mapas.

O Authorization URL é específico para a instância de nuvem pública do Azure. As nuvens soberanas têm URLs de autorização exclusivas e configurações de ID do Microsoft Entra. * O controle de acesso baseado em função do Azure é configurado no plano de gerenciamento do Azure por meio do portal do Azure, do PowerShell, da CLI, dos SDKs do Azure ou das APIs REST. * O uso do SDK da Web do Azure Mapas permite a configuração baseada em configuração de um aplicativo para vários casos de uso.

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

Escopos

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

subscription-key

Essa é uma chave compartilhada provisionada ao criar um recurso do Azure Mapas por meio do plano de gerenciamento do Azure por meio do portal do Azure, do PowerShell, da CLI, dos SDKs do Azure ou das APIs REST.

Com essa chave, qualquer aplicativo está autorizado a acessar todas as APIs REST. Em outras palavras, elas podem atualmente ser tratadas como chaves mestras para a conta para a qual são emitidas.

Para aplicativos expostos publicamente, nossa recomendação é usar o acesso de servidor a servidor de APIs REST do Azure Mapas em que essa chave pode ser armazenada com segurança.

Tipo: apiKey
Em: header

SAS Token

Esse é um token de assinatura de acesso compartilhado criado a partir da operação Listar SAS no recurso do Azure Mapas por meio do plano de gerenciamento do Azure por meio do portal do Azure, do PowerShell, da CLI, dos SDKs do Azure ou das APIs REST.

Com esse token, qualquer aplicativo está autorizado a acessar com controles de acesso baseados em função do Azure e controle refinado à expiração, taxa e regiões de uso para o token específico. Em outras palavras, o Token SAS pode ser usado para permitir que os aplicativos controlem o acesso de maneira mais segura do que a chave compartilhada.

Para aplicativos expostos publicamente, nossa recomendação é configurar uma lista específica de origens permitidas no recurso de conta do Mapa para limitar o abuso de renderização e renovar regularmente o Token SAS.

Tipo: apiKey
Em: header

Exemplos

Successful Static Image Request

Solicitação de exemplo

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

Resposta de exemplo

Content-Type: image/png
"{file}"

Definições

Nome Description
ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

LocalizedMapView

O parâmetro View (também chamado de parâmetro "região do usuário") permite mostrar os mapas corretos para um determinado país/região para regiões geopolíticas disputadas. Diferentes países/regiões têm diferentes exibições dessas regiões e o parâmetro View permite que seu aplicativo cumpra a exibição exigida pelo país/região que seu aplicativo atenderá. 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/região em que são disponibilizados mapas, imagens e outros dados e conteúdo de terceiros que você está autorizado a acessar por meio do Azure Mapas. Exemplo: view=IN.

Consulte Modos de exibição com suporte para obter detalhes e para ver as Exibições disponíveis.

MediaType

O campo Aceitar cabeçalho pode ser usado para especificar preferências relacionadas aos tipos de mídia de resposta. Os tipos de mídia permitidos incluem image/jpeg e image/png. Retornar imagem em image/png se Accept header não for especificado.

TilesetId

Estilo de mapa a ser retornado. Os valores possíveis são microsoft.base.road, microsoft.base.darkgrey e microsoft.imagery. O valor padrão é definido como microsoft.base.road. Para obter mais informações, consulte Renderizar TilesetId.

TrafficTilesetId

Valor opcional, indicando que nenhum fluxo de tráfego sobreposto ao resultado da imagem. Os valores possíveis são microsoft.traffic.relative.main e nenhum. O valor padrão é nenhum, indicando que nenhum fluxo de tráfego retornado. Se tilesetId relacionado ao tráfego for fornecido, retornará a imagem do mapa com a camada de tráfego correspondente. Para obter mais informações, consulte Renderizar TilesetId.

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Nome 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 de erro

Nome Tipo Description
error

ErrorDetail

O objeto de erro.

LocalizedMapView

O parâmetro View (também chamado de parâmetro "região do usuário") permite mostrar os mapas corretos para um determinado país/região para regiões geopolíticas disputadas. Diferentes países/regiões têm diferentes exibições dessas regiões e o parâmetro View permite que seu aplicativo cumpra a exibição exigida pelo país/região que seu aplicativo atenderá. 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/região em que são disponibilizados mapas, imagens e outros dados e conteúdo de terceiros que você está autorizado a acessar por meio do Azure Mapas. Exemplo: view=IN.

Consulte Modos de exibição com suporte para obter detalhes e para ver as Exibições disponíveis.

Nome Tipo Description
AE

string

Emirados Árabes Unidos (Exibição Árabe)

AR

string

Argentina (Exibição Argentina)

Auto

string

Retornar os dados do mapa com base no endereço IP da solicitação.

BH

string

Bahrein (Exibição Árabe)

IN

string

Índia (Exibição Indiana)

IQ

string

Iraque (Exibição Árabe)

JO

string

Jordânia (Exibição Árabe)

KW

string

Kuwait (Exibição Árabe)

LB

string

Líbano (Exibição Árabe)

MA

string

Marrocos (Exibição Marroquina)

OM

string

Omã (Exibição Árabe)

PK

string

Paquistão (Exibição Paquistanesa)

PS

string

Autoridade Palestina (Exibição Árabe)

QA

string

Qatar (Exibição Árabe)

SA

string

Arábia Saudita (Exibição Árabe)

SY

string

Síria (Exibição Árabe)

Unified

string

Exibição Unificada (Outras)

YE

string

Iêmen (Exibição Árabe)

MediaType

O campo Aceitar cabeçalho pode ser usado para especificar preferências relacionadas aos tipos de mídia de resposta. Os tipos de mídia permitidos incluem image/jpeg e image/png. Retornar imagem em image/png se Accept header não for especificado.

Nome Tipo Description
image/jpeg

string

Retornar imagem no formato jpeg.

image/png

string

Retornar imagem no formato png.

TilesetId

Estilo de mapa a ser retornado. Os valores possíveis são microsoft.base.road, microsoft.base.darkgrey e microsoft.imagery. O valor padrão é definido como microsoft.base.road. Para obter mais informações, consulte Renderizar TilesetId.

Nome Tipo Description
microsoft.base.darkgrey

string

TilesetId contém todas as camadas com nosso estilo cinza escuro.

microsoft.base.road

string

TilesetId contém todas as camadas com estilo principal de renderização.

microsoft.imagery

string

TilesetId contém uma combinação de imagens de satélite e aérea.

TrafficTilesetId

Valor opcional, indicando que nenhum fluxo de tráfego sobreposto ao resultado da imagem. Os valores possíveis são microsoft.traffic.relative.main e nenhum. O valor padrão é nenhum, indicando que nenhum fluxo de tráfego retornado. Se tilesetId relacionado ao tráfego for fornecido, retornará a imagem do mapa com a camada de tráfego correspondente. Para obter mais informações, consulte Renderizar TilesetId.

Nome Tipo Description
microsoft.traffic.relative.main

string

TilesetId relacionado ao tráfego com suporte.

none

string

Valor padrão, sem sobreposição de fluxo de tráfego.