Configurar a API do Google Maps

Você habilita o recurso de geolocalização usando as entradas apropriadas de uma licença da Google Maps API for Business ou de uma Google Maps JavaScript API Key.

Antes de Iniciar

Função necessária: administrador

Por Que e Quando Desempenhar Esta Tarefa

Você pode gerar mapas usando JavaScript básico e eles são flexíveis o suficiente para exibir até mesmo as consultas mais complicadas. Esses mapas usam recursos de mapeamento padrão Google Maps API for Business ou Google Maps JavaScript API Key, incluindo vários tipos de link para registros em sua instância. O uso deste recurso requer a instalação do plug-in Google Maps.

Figura 1. Página de mapa

Procedimento

1. Google As licenças das APIs do Maps para empresas não estão mais disponíveis em Google, portanto, dependendo se você tiver uma licença existente, use um dos procedimentos a seguir.
   Nota:

   Você deve usar sua própria chave de API JavaScript do Google Maps de Google e não usar nenhuma chave gerada por Now Platform®.

   Existe uma licença da Google Maps API for Business disponível?	Tarefas
   Licença existente disponível	No Propriedades do sistema > Google Maps formulário de propriedade: No campo google.maps.client, insira o ID de cliente da sua organização. Este ID é de Google e começa com gme-, como gme-mycompanyname. No campo google.maps.private.key, insira a chave privada da Google Maps API for Business. Um exemplo de uma chave codificada é vNIXE0xscrmjlyV-12Nj_BvUPaw=. O Now Platform® requer esta chave para recuperar estimativas precisas de tempo de condução de Google para alguns recursos de geolocalização. Preencha os valores restantes no formulário. Configure seus mapas usando as definições de propriedade da tabela. Nota: Consulte o Guia de Introdução no site Google para obter detalhes sobre como obter uma chave usando a API e os termos de serviço relevantes.
   Nenhuma licença disponível	Obtenha uma Google chave de API JavaScript do Maps de Google. No Propriedades do sistema > Google Maps formulário de propriedade, insira a chave de API no campo google.maps.key. A geolocalização em Now Platform® usa a chave de API, que Google Maps também usa para geolocalização e cobranças de exibição de mapa. Preencha os valores restantes no formulário. Configure seus mapas usando as definições de propriedade da tabela.

   Para saber mais sobre a Google Maps API for Business e a Google Maps JavaScript API Key, consulte https://developers.google.com/maps/gmp-get-started.
2. Depois de concluir e salvar a configuração, crie páginas de mapa ou use as páginas padrão incluídas com o plug-in.
   As páginas de mapa definem quais dados aparecem no mapa e a aparência dos links. Para obter um tutorial sobre como exibir todos os marcadores vinculados aos seus registros, consulte a publicação do blog Exibir marcadores de mapa no Google Maps na ServiceNow Community.

   Propriedade	Descrição
   google.maps.auto_close	Se verdadeiro, fechará automaticamente uma janela de informações de mapa antes de abrir uma nova. Tipo: verdadeiro/falso Valor padrão: verdadeiro Local: Propriedades do sistema > Google Maps
   google.maps.cliente	ID de cliente da Google Maps API for Business. Tipo: cadeia de caracteres Valor padrão: gme-servicenow Local: Propriedades do sistema > Google Maps
   google.maps.private.key	Chave privada da Google Maps API for Business. Esta chave ativa o recurso de geolocalização, que localiza os usuários no sistema com precisão, usando dados de seus dispositivos móveis. Tipo: cadeia de caracteres Valor padrão: vazio Local: Propriedades do sistema > Google Maps
   google.maps.version	Número da versão da instalação atual da Google Maps API for Business. Tipo: cadeia de caracteres Valor padrão: número da versão atual Local: Propriedades do sistema > Google Maps
   google.maps.key	Google Maps API for Business ou Google Maps JavaScript API Key vinculada ao URL do servidor. Esta chave autoriza o uso de desenvolvimento da Google Maps API. Tipo: cadeia de caracteres Valor padrão: vazio Local: Propriedades do sistema > Google Maps
   google.maps.latitude	Latitude inicial do mapa. Este valor determina a posição inicial exibida em Google Mapas. Tipo: cadeia de caracteres Valor padrão: 36,008522 Local: Propriedades do sistema > Google Maps
   google.maps.longitude	Longitude inicial do mapa. Este valor determina a posição inicial exibida nas páginas de Google Mapas. Tipo: cadeia de caracteres Valor padrão: -95,221764 Local: Propriedades do sistema > Google Maps
   google.maps.max_items	Número máximo de itens a serem exibidos no mapa. Tipo: inteiro Valor padrão: 500 Local: Propriedades do sistema > Google Maps
   google.mapas.tabela	Tabela usada pelo mapa. A tabela precisa dos seguintes campos: nome, longitude, latitude. Tipo: cadeia de caracteres Valor padrão: cmn_location Local: Propriedades do sistema > Google Maps
   google.mapas.zoom	Nível de zoom inicial do mapa (1 é o mais baixo) Tipo: cadeia de caracteres Valor padrão: 4 Local: Propriedades do sistema > Google Maps

3. Execute estas configurações:
   1. Navegar até Propriedades do sistema > Todos.
   2. Defina valores para estas propriedades do sistema:

      Propriedade do sistema	Descrição
      google.maps.refresh.latlong.duration	Número de dias após o qual os detalhes do local são atualizados. Nota: O valor máximo é 30.
      google.maps.refresh.latlong.record_count_per_table	Número máximo de registros em uma tabela que podem ser processados usando o trabalho agendado em uma atualização.

   3. Especifique as tabelas que armazenam os detalhes do local na tabela Configuração de atualização de coordenadas do mapa [cmn_coordenadas_refresh_config].
   4. Se não houver campos para rastrear quando as coordenadas forem recuperadas pela última vez em suas tabelas:
      1. Crie o campo coordenadas_retrieved_on do tipo Data/Hora em suas tabelas.
      2. Certifique-se de que o valor do campo que rastreia o tempo quando as coordenadas são recuperadas pela última vez esteja preenchido corretamente na tabela Configuração de atualização de coordenadas do mapa [cmn_coordenadas_refresh_config]. Consulte o script de correção de exemplo Atualizar coordenadas atualizadas no campo para atualizar os valores no campo coordenadas_retrieved_on.
   5. Navegar até Definição do Sistema > Trabalhos agendados.
   6. Abra o registro, atualize as informações de latitude e longitude dos registros.
   7. Marque a caixa de seleção Ativo.
   8. Especifique a frequência com que os detalhes do local devem ser atualizados fornecendo detalhes de frequência em Intervalo de execução e repetição.
      Nota:

      Certifique-se de atualizar os detalhes do local pelo menos uma vez a cada 30 dias.
4. Opcional: Para acessar Google Mapas da instância ServiceNow com base em sua região, execute estas configurações.
   1. Navegar até Administração de usuários > Usuários.
   2. Selecione e atribua o código do país relevante ao usuário necessário.
      Nota:

      Se o código do país necessário não estiver disponível, adicione a entrada do dicionário. Certifique-se de usar os códigos de país ISO 3166-1. Por exemplo, o código do país para o país é MA.
   3. Navegar até Propriedades do sistema > Google Maps.
   4. Marque a caixa de seleção Sim para Habilite esta propriedade somente quando quiser alterar o comportamento do mapa do Google com base em uma região. A região é preenchida a partir do valor do campo "Código do país" do usuário atual no registro sys_user. O valor do código do país no registro sys_user deve ser consistente com as expectativas do código de região do Google Maps. A maioria dos identificadores de região Unicode é idêntica aos códigos ISO 3166-1, com algumas exceções notáveis. Verifique os códigos corretamente antes de fazer qualquer mudança.
   5. Clique em Salvar.

Tarefas relacionadas

• Criar uma página de mapa
• Criar um módulo de página de mapa
• Criar uma Página de Mapa avançada
• Definir escopo da aplicação de mapa
• Criar um módulo de página de mapa para smartphone

Referência relacionada

• Script para páginas de mapa