Visão geral da API Map Management

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

A API Map Management é destinada a desenvolvedores que querem gerenciar configurações de mapas em grande escala ou integrar a estilização 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 destaque de PDIs ou nivelamento de edifícios.
  • MapContextConfig: associa um StyleConfig (e, opcionalmente, um ou mais conjuntos de dados) a um MapVariants específico 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 desse canal podem mudar sem aviso prévio e não são recomendados para uso em produção.
  • v2beta (pré-lançamento): contém recursos estáveis que estão sendo preparados para disponibilidade geral. Esse canal é adequado para adoção inicial e testes 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 é compatível com 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 do Google Cloud.
  • Escopo de recursos: essa API se concentra no gerenciamento de recursos de estilização de mapas baseada 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 limitadas 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 diariamente

Consulte Uso e faturamento.