--- sourceDocument: Interface do usuário da Now Platform Yokohama sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/platform-user-interface Release : - yokohama ft:locale : - pt-BR ft:publication_title : - Interface do usuário da Now Platform Yokohama ft:clusterId : - platux bundleId : - platux workflow : - Platform --- # Configurar a API do Google Maps # Configurar a API do Google Maps {#ariaid-title1} * Versão de lançamento: Yokohama * * Atualizado 30 de jan. de 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 min. de leitura Você habilita o recurso de geolocalização usando as entradas apropriadas de um GoogleAPI de mapas para negócios, ou um GoogleChave de API JavaScript do mapeia. ## 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 GoogleAPI de mapas para negócios ou GoogleMapeia 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 GooglePlug-in de mapas. Figura 1. Página de mapa ## Procedimento 1. GoogleAs APIs do MAPS para licenças de negócios 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 de Googlee não use nenhum Now Platform®chave gerada. | Existente GoogleLicença da API do Maps for Business disponível? | Tarefas | | Licença existente disponível | 1. Em Propriedades do sistemaGoogle Maps formulário de propriedade: * Em google.maps.client Insira o ID do cliente da sua organização. Este ID é de Googlee começa com `gme- `, como `mme-mycompanyname `. * Em google.maps.private.key insira a chave privada para GoogleAPI de mapas para negócios. Um exemplo de uma chave codificada é `VNIXE0xscrmjlyV-12Nj_BvUPaw `. . Now Platform®requer esta chave para recuperar estimativas precisas de tempo de condução de GooglePara alguns recursos de geolocalização. * Preencha os valores restantes no formulário. {#set-up-google-maps-api__ul_wxf_1sj_smb} 2. Configure seus mapas usando as definições de propriedade da tabela. {#set-up-google-maps-api__ol_hqp_wnj_smb} Nota: Consulte [Guia de introdução](https://developers.google.com/maps/documentation/javascript/tutorial)em GoogleSite para obter detalhes sobre como obter uma chave, usar a API e termos de serviço relevantes. | | Nenhuma licença disponível | 1. Obtenha um GoogleMapeia a chave de API JavaScript de Google. 2. Em Propriedades do sistemaGoogle Maps Formulário de propriedade, insira a chave de API no google.maps.key campo. Geolocalização no Now Platform®Usa a chave de API, que GoogleO Maps também é usado para faturamentos de geolocalização e exibição de mapa. 3. Preencha os valores restantes no formulário. 4. Configure seus mapas usando as definições de propriedade da tabela. {#set-up-google-maps-api__ol_qnd_vpj_smb} | |-|-| {#set-up-google-maps-api__choicetable_okq_vnj_smb} Para saber mais sobre GoogleAPI de mapas para negócios, e. GoogleChave de API JavaScript do Mapas, consulte . 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](https://community.servicenow.com/community?id=community_blog&sys_id=909ceae1dbd0dbc01dcaf3231f96192b)publicação do blog no Comunidade ServiceNow. {#set-up-google-maps-api__table_edd_4zf_vt__entry__2} | 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 sistemaGoogle Maps {#set-up-google-maps-api__ul_zb5_slr_bq} | | google.maps.client | ID do cliente para GoogleAPI de mapas para negócios. * Tipo: cadeia de caracteres * Valor padrão: gme-seceNow * Local: Propriedades do sistemaGoogle Maps {#set-up-google-maps-api__ul_pyj_ylr_bq} | | google.maps.private.key | Chave privada para GoogleAPI de mapas para negócios. Essa 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 sistemaGoogle Maps {#set-up-google-maps-api__ul_j1k_zlr_bq} | | google.maps.versão | Número da versão da instalação atual de GoogleAPI de mapas para negócios. * Tipo: cadeia de caracteres * Valor padrão: Número da versão atual * Local: Propriedades do sistemaGoogle Maps {#set-up-google-maps-api__ul_acs_zlr_bq} | | google.maps.key | GoogleAPI de mapas para negócios ou GoogleMapeia a chave da API JavaScript vinculada ao URL do servidor. Esta chave autoriza o uso de desenvolvimento de GoogleAPI de mapas. * Tipo: cadeia de caracteres * Valor padrão: vazio * Local: Propriedades do sistemaGoogle Maps {#set-up-google-maps-api__ul_zsx_zlr_bq} | | google.maps.latitude | Latitude inicial do mapa. Este valor determina a posição inicial exibida em GoogleMapas. * Tipo: cadeia de caracteres * Valor padrão: 36,008522 * Local: Propriedades do sistemaGoogle Maps {#set-up-google-maps-api__ul_qvc_1mr_bq} | | google.maps.longitude | Longitude inicial do mapa. Este valor determina a posição inicial exibida em GooglePáginas de mapas. * Tipo: cadeia de caracteres * Valor padrão: -95,221764 * Local: Propriedades do sistemaGoogle Maps {#set-up-google-maps-api__ul_pbp_1mr_bq} | | google.maps.max_items | Número máximo de itens a serem exibidos no mapa. * Tipo: inteiro * Valor padrão: 500 * Local: Propriedades do sistemaGoogle Maps {#set-up-google-maps-api__ul_lgy_1mr_bq} | | 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 sistemaGoogle Maps {#set-up-google-maps-api__ul_xyd_bmr_bq} | | 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 sistemaGoogle Maps {#set-up-google-maps-api__ul_tys_bmr_bq} | [ ] {#set-up-google-maps-api__table_edd_4zf_vt} 3. Execute estas configurações: 1. Navegar até Propriedades do sistemaTudo. 2. Defina valores para estas propriedades do sistema: {#set-up-google-maps-api__table_dww_kh2_r4b__entry__2} | 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. | [ ] {#set-up-google-maps-api__table_dww_kh2_r4b} 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 no coordinates_retrieved_on campo. {#set-up-google-maps-api__ol_rt4_m32_r4b} 5. Navegar até Definição do SistemaTrabalhos agendados. 6. Abrir o registro, Atualize as informações de longitude de 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. {#set-up-google-maps-api__substeps_fqt_gh2_r4b} 4. **Opcional:** Para acessar GoogleMapas do ServiceNowcom base em sua região, execute estas configurações. 1. Navegar até Administração de usuáriosUsuá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 sistemaGoogle Maps. 4. Selecione Sim caixa de seleção para Habilite esta propriedade somente quando você 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. {#set-up-google-maps-api__substeps_xs5_vk5_kqb} **Tarefas relacionadas** * [Crie uma página de mapa](https://servicenow-prod.fluidtopics.net/kf45GgaQmeqEAVIpdxA0uQ "Seu ServiceNowa instância fornece várias páginas de mapa padrão. Você também pode criar páginas de mapa personalizadas com os exemplos de script descritos nesta página.") * [Crie um módulo de página de mapa](https://servicenow-prod.fluidtopics.net/jGwRq2l9Rq1iIA0~AWdaCA "Você pode criar um novo módulo de aplicação para que os usuários de desktop ou smartphone exibam um Googlepágina do mapa.") * [Crie uma página de mapa avançada](https://servicenow-prod.fluidtopics.net/1GOLiq0CJtf__K4tdeIibw "Use a configuração avançada para configurar páginas de mapa sem script.") * [Definir escopo da aplicação de mapa](https://servicenow-prod.fluidtopics.net/qHTar20aXTM9p367An7XNQ "Habilite o escopo da aplicação de mapa para especificar qual aplicação pode modificar a configuração da página de mapa.") * [Crie um módulo de página de mapa do smartphone](https://servicenow-prod.fluidtopics.net/gyI_DKwXqiFgarUcwpNWIA "Você pode criar um módulo de smartphone personalizado vinculado diretamente a uma página de mapa.") **Referência relacionada** * [Scripting para páginas de mapa](https://servicenow-prod.fluidtopics.net/RtWdL~vWqc5634qlLMS1Qw "O campo Script no formulário Página de mapa permite o uso de atributos ou código personalizado para definir características do mapa, como aparência do marcador, informações de exibição e muito mais.")