Por que as Chaves ESRI Map não funcionam mais?

Sintomas

Ao tentar usar um ESRI Map, eu recebo a mensagem de erro “Server service is unavailable or Invalid ESRI Maps Key" (Serviço do servidor indisponível ou a chave do ESRI Maps é inválida) no canto inferior direito da tela.

Causa

Causas possíveis:

  • Em 26 de Fevereiro de 2025, a ESRI alterou seus endpoints para os mapas ESRI Streets, ESRI Light, e ESRI Dark.

    Ao usar o BricsCAD V24.2.X e V25.1.X, você vai encontrar um erro "Server service is unavailable or Invalid ESRI Maps Key" (Serviço do Servidor não está disponível ou a chave do ESRI Maps é inválida) ao tentar usar esses mapas.

  • A chave da API expirou.
  • A chave da API tem URLs de referência.

Solução

  • Para resolver isso nas versões mencionadas do BricsCAD, você precisa atualizar manualmente os endpoints na seção Online Maps Services (Serviços de Mapas Online) da caixa de diálogo Configurações.

    Os novos endpoints devem ser definidos da seguinte forma:

    • Static Streets Metadata: https://static-map-tiles-api.arcgis.com/arcgis/rest/services/static-basemap-tiles-service/v1/arcgis/streets/static
    • Static Streets Tile: https://static-map-tiles-api.arcgis.com/arcgis/rest/services/static-basemap-tiles-service/v1/arcgis/streets/static/tile/{level}/{row}/{column}
    • Static Light gray Metadata: https://static-map-tiles-api.arcgis.com/arcgis/rest/services/static-basemap-tiles-service/v1/arcgis/light-gray/static
    • Static Light gray Tile: https://static-map-tiles-api.arcgis.com/arcgis/rest/services/static-basemap-tiles-service/v1/arcgis/light-gray/static/tile/{level}/{row}/{column}
    • Static Dark gray Metadata: https://static-map-tiles-api.arcgis.com/arcgis/rest/services/static-basemap-tiles-service/v1/arcgis/dark-gray/static
    • Static Dark gray Tile: https://static-map-tiles-api.arcgis.com/arcgis/rest/services/static-basemap-tiles-service/v1/arcgis/dark-gray/static/tile/{level}/{row}/{column}
  • Para ver se sua chave de API expirou, você precisa acessar suas credenciais de chave de API. Se sua chave expirou, você pode gerar uma nova.
  • Para ver se sua chave de API tem URLs de referência, você precisa acessar suas credenciais de chave de API. Se alguma entrada estiver listada, esta deverá ser excluída.
    Nota: Ao atualizar os referenciadores invalida sua chave de API. Se você alterar os referenciadores, também precisará regenerar sua chave existente ou gerar uma nova.

Como acessar suas credenciais de chave de API

  1. Entre em sua conta na ArcGIS Location Platform. Clique no botão Entrar (1).
  2. Depois de entrar no painel do ArcGIS Location Platform, role para baixo até Developer credentials (Credenciais do desenvolvedor) (2). Escolha a chave de API relevante e clique no botão Manage credential (Gerenciar credencial) (3).
  3. Uma nova aba do navegador com a Visão geral da chave de API é aberta. Selecione Settings (Configurações) (4) no canto superior direito da página.
  4. Agora você pode ver ou modificar suas configurações de chave de API.

    Role para baixo até API keys (Chaves) (5) para verificar a data de validade ou até Referrers (Referenciadores) (6) para ver se há entradas listadas.