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 uma Google Chave de API JavaScript do Maps.

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 na Google. Portanto, dependendo se você tem 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 qualquer chave gerada por Now Platform®.

   Existente Google Licença do 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 chave codificada é vNIXE0xscrmjlyV-12Nj_BvUPaw=. O Now Platform® requer esta chave para recuperar estimativas precisas de tempo de carro 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 chave de API JavaScript de mapas [ Google 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 no Now Platform® usa a chave de API, que o Google Mapas também usa para geolocalização e faturamento 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 Google Maps API for Business e 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 do 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 em ServiceNow Community.

   Propriedade	Descrição
   google.maps.auto_close	Se for 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.client	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 para 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 que está vinculada ao URL do servidor. Esta chave autoriza o uso de desenvolvimento da Google API de mapas. 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	Iniciando a longitude do mapa. Este valor determina a posição inicial exibida em Google Páginas de 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.maps.table	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.maps.zoom	Iniciando o nível de zoom 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 os quais 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 programado 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 a hora em que as coordenadas foram recuperadas pela última vez está 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 programados.
   6. Abra o registro, Atualizar informações de latitude e longitude de 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 Executar e Intervalo de repetição.
      Nota:

      Certifique-se de atualizar os detalhes do local pelo menos uma vez a cada 30 dias.
4. Opcional: Para acessar mapas GoogleServiceNow da instância [] 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 para o 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 Habilitar 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 mapa do Google. 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 de smartphone

Referência relacionada

• Script para páginas de mapa