Configurar a API do Google Maps

Você habilita o recurso de geolocalização usando as entradas apropriadas de um Google API do Maps for Business, ou um Google Chave de API JavaScript dos mapas.

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 padrão Google API de mapas para negócios ou Google Mapeia recursos de mapeamento de chave da API JavaScript, incluindo vários tipos de link para registros em sua instância. O uso deste recurso requer a instalação do Google Plug-in Mapas.

Figura 1. Página de mapa

Procedimento

1. Google As licenças das APIs do Maps for Business não estão mais disponíveis em Google, portanto, dependendo de ter uma licença existente, use um dos procedimentos a seguir.
   Nota:

   Você deve usar sua própria chave de API JavaScript do Google Maps do Google e não use nenhum ServiceNow AI Platform® chave gerada.

   Existente Google Licença da API do Maps for Business disponível?	Tarefas
   Licença existente disponível	Em Propriedades do sistema > Google Maps formulário de propriedade: Em google.maps.client Campo, insira o ID do cliente da sua organização. Este ID é de Google e começa com gme- , como mme-mycompanyname . Em google.maps.private.key , insira a chave privada para Google API de mapas para negócios. Um exemplo de uma chave codificada é VNIXE0xscrmjlyV-12Nj_BvUPaw . . ServiceNow AI Platform® o requer esta chave para recuperar estimativas precisas de tempo de condução do 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 Guia de introdução em Google Site para obter detalhes sobre como obter uma chave, usar a API e termos de serviço relevantes.
   Nenhuma licença disponível	Obtenha um Google Mapeia a chave de API JavaScript de Google. Em Propriedades do sistema > Google Maps Formulário de propriedade, insira a chave de API em google.maps.key campo. Geolocalização no ServiceNow AI Platform® Usa a chave de API, que Google O Maps também usa para Geolocalização e faturamentos 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 API de mapas para negócios, e. Google Chave de API JavaScript dos mapas, 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 Mostrar marcadores de mapa no Google Maps publicação do blog no Comunidade ServiceNow.

   Propriedade	Descrição
   google.maps.auto_close	Se verdadeiro, fecha automaticamente uma janela de informações do mapa antes de abrir uma nova. Tipo: Verdadeiro/falso Valor padrão: verdadeiro Local: Propriedades do sistema > Google Maps
   google.maps.client	ID do cliente para Google API de mapas para negócios. Tipo: cadeia de caracteres Valor padrão: gme-seceNow Local: Propriedades do sistema > Google Maps
   google.maps.private.key	Chave privada para Google API de mapas para negócios. 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 de Google API de mapas para negócios. Tipo: cadeia de caracteres Valor padrão: Número da versão atual Local: Propriedades do sistema > Google Maps
   google.maps.key	Google API de mapas para negócios ou Google Chave de API JavaScript do mapeia que está vinculada ao URL do servidor. Esta chave autoriza o uso de desenvolvimento de 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	Longitude inicial 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	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 > Tudo.
   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 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_coordinate_refresh_config].
   4. Se não houver campos para rastrear quando as coordenadas foram recuperadas pela última vez em suas tabelas:
      1. Crie o. coordinates_retrieved_on campo do tipo Data/Hora em suas tabelas.
      2. Certifique-se de que o valor do campo que rastreia o tempo em que as coordenadas foram recuperadas pela última vez seja preenchido corretamente na tabela Configuração de atualização de coordenadas do mapa [cmn_coordinate_refresh_config]. Consulte o script de correção de amostra Atualizar coordenadas atualizadas no campo para atualizar valores em coordinates_retrieved_on campo.
   5. Navegar até Definição do Sistema > Trabalhos agendados.
   6. Abrir o registro, Atualize as informações de longitude da latitude dos registros .
   7. Marque a caixa de seleção Ativo.
   8. Especifique a frequência na qual os detalhes do local devem ser atualizados fornecendo detalhes de frequência em Executar e. Intervalo de repetição .
      Nota:

      Atualize os detalhes do local pelo menos uma vez a cada 30 dias.
4. Opcional: Para acessar Google Mapas do 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 relevante Código do país para o usuário necessário.
      Nota:

      Se for necessário Código do país não está 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 de Marrocos é MA .
   3. Navegar até Propriedades do sistema > Google Maps.
   4. Selecione Sim caixa de seleção para Habilite esta propriedade somente quando quiser alterar o comportamento do Google Map 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 são idênticos 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 do smartphone

Referência relacionada

• Scripts para páginas de mapa