Visão geral da API Map Management

A API Map Management é uma API RESTful que pode ser usada para gerenciar programaticamente seus recursos de estilização de mapas baseada na nuvem. Com essa API, é possível definir a aparência visual dos mapas, gerenciar identidades de mapas e associar estilos e conjuntos de dados personalizados a variantes de mapas específicas, tudo sem usar o console do Cloud.

A API Map Management foi projetada para desenvolvedores que querem realizar o gerenciamento em grande escala de configurações de mapas ou integrar o estilo de mapas aos próprios fluxos de trabalho automatizados e ferramentas internas.

Principais recursos

  • StyleConfig: contém a representação JSON de um estilo de mapa. Isso define as cores, a visibilidade e a densidade dos elementos do mapa.
  • MapConfig: representa uma identidade de mapa exclusiva (ID do mapa). Ele funciona como um contêiner para configurações de estilo e recursos, como o aumento de pontos de interesse ou o achatamento de edifícios.
  • MapContextConfig: associa um StyleConfig (e, opcionalmente, um ou mais conjuntos de dados) a MapVariants específicos em um MapConfig.

Canais de controle de versões da API

A API Map Management usa o controle de versões baseado em canais para fornecer um caminho claro de recursos experimentais para disponibilidade geral estável.

  • v2alpha (experimental): contém os recursos experimentais mais recentes. Os recursos nesse canal podem mudar sem aviso prévio e não são recomendados para uso em produção.
  • v2beta (prévia): contém recursos estáveis e que estão sendo preparados para disponibilidade geral. Esse canal é adequado para adoção e testes iniciais em ambientes de pré-produção.
  • v2 (disponibilidade geral): contém recursos totalmente compatíveis e prontos para produção.

A maioria dos recursos da v2 está disponível nos endpoints v2alpha e v2beta durante as respectivas fases de lançamento. Para novos usuários, o Google recomenda começar com o endpoint v2beta.

Autenticação

Você só pode usar o OAuth 2.0 para autenticar com a API Map Management, que não oferece suporte a chaves de API. Para mais informações, consulte Usar o OAuth.

Limitações

  • Papéis de desenvolvedor: para usar a API Map Management, você precisa ter as permissões do IAM necessárias para gerenciar os recursos da Plataforma Google Maps no seu projeto na nuvem do Google.
  • Escopo do recurso: essa API se concentra no gerenciamento de recursos de estilo de mapas baseados na nuvem. Outras configurações da Plataforma Google Maps ainda podem exigir o console do Cloud.

Custos

Não há cobrança pelo uso da API Map Management. As chamadas de API aparecem na página de faturamento no console do Cloud, mas as cobranças serão de US $0. No entanto, as solicitações são restritas da seguinte maneira:

  • 3 QPS (consultas por segundo)
  • 180 QPM (consultas por minuto) para um projeto, atualizadas a cada minuto
  • 100.000 QPD (consultas por dia) para um projeto, atualizadas a cada dia

Consulte Uso e faturamento.