Mostrar a atribuição correta de direitos autorais

Ao usar o serviço de Renderização do Azure Maps, como um mapa base ou camada, é necessário exibir a atribuição de direitos autorais do provedor de dados apropriada no mapa. Esta informação deve ser exibida no canto inferior direito do mapa.

The above image is an example of a map from the Render service showing the copyright attribution when using the road style

A imagem acima é um exemplo de um mapa do serviço Render, exibindo o estilo da estrada. Ele mostra a atribuição de direitos autorais no canto inferior direito do mapa.

The above image is an example of a map from the Render service showing the copyright attribution when using the satellite style

A imagem acima é um exemplo de um mapa do serviço Render, exibindo o estilo de satélite. Observe que há outro provedor de dados listado.

A API Get Map Attribution

A API Get Map Attribution permite que você solicite informações de atribuição de direitos autorais de mapa para que você possa exibir no mapa em seus aplicativos.

Quando usar a API Get Map Attribution

As informações de atribuição de direitos autorais do mapa devem ser exibidas no mapa em todos os aplicativos que usam a API de renderização, incluindo aplicativos da Web e móveis.

A atribuição é exibida e atualizada automaticamente no mapa Ao usar qualquer um dos SDKs do Azure Maps, incluindo os SDKs da Web, Android e iOS .

Ao usar blocos de mapa do serviço Renderizar em um mapa de terceiros, você deve exibir e atualizar as informações de atribuição de direitos autorais no mapa.

O conteúdo do mapa muda sempre que um usuário final seleciona um estilo diferente, aumenta ou diminui o zoom ou desloca o mapa. Cada uma dessas ações do usuário faz com que um evento seja acionado. Quando qualquer um desses eventos for acionado, você precisará chamar a API Get Map Attribution. Depois de ter as informações de atribuição de direitos autorais atualizadas, você precisa exibi-las no canto inferior direito do mapa.

Como os provedores de dados podem diferir dependendo da região e do nível de zoom, a API Get Map Attribution usa esses parâmetros como entrada e retorna o texto de atribuição correspondente.

Como usar a API Get Map Attribution

Você precisa das seguintes informações para executar o attribution comando:

Parâmetro Type Description
api-version string Número da versão da API do Azure Maps.
limites matriz Uma cadeia de caracteres que representa a área retangular de uma caixa delimitadora. O parâmetro bounds é definido pelas quatro coordenadas da caixa delimitadora. Os 2 primeiros são a longitude e latitude WGS84 que definem o canto sudoeste e os últimos 2 são a longitude e latitude WGS84 que definem o canto nordeste. A cadeia de caracteres é apresentada no seguinte formato: [SouthwestCorner_Longitude, SouthwestCorner_Latitude, NortheastCorner_Longitude, NortheastCorner_Latitude].
tilesetId TilesetID Um conjunto de blocos é uma coleção de dados raster ou vetoriais divididos em uma grade uniforme de blocos quadrados em níveis de zoom predefinidos. Cada tileset tem um tilesetId para usar ao fazer solicitações. O tilesetId para conjuntos de blocos criados usando o Azure Maps Creator é gerado por meio da API Tileset Create. Há conjuntos de blocos prontos para uso fornecidos pelo Azure Maps, como microsoft.base.road, e microsoft.weather.radar.main, microsoft.base.hybrid uma lista completa pode ser encontrada na documentação da API REST Get Map Attribution.
Zoom integer Nível de zoom para o bloco selecionado. O intervalo válido depende do bloco, consulte a tabela TilesetID para obter valores válidos para um conjunto de blocos específico. Para obter mais informações, consulte o artigo Níveis de zoom e grade de blocos.
chave de subscrição string Uma das chaves do Azure Maps fornecidas a partir de uma Conta de Mapa do Azure. Para obter mais informações, consulte o artigo Autenticação com mapas do Azure.

Execute a seguinte solicitação GET para obter a atribuição de direitos autorais correspondente para exibir no mapa:

https://atlas.microsoft.com/map/attribution?subscription-key={Your-Azure-Maps-Subscription-key}&api-version=2.1&tilesetId=microsoft.base&zoom=6&bounds=-122.414162,47.579490,-122.247157,47.668372

Informações adicionais

  • Para obter mais informações, consulte a documentação do serviço de renderização.