Loading

Perguntas frequentes sobre geocodificação do Maps

Data da publicação: May 1, 2026
Resolução

Veja a seguir a lista de perguntas frequentes sobre a geocodificação do Maps:


Nota: o serviço GeoCode é assíncrono e pode haver um pequeno atraso na atualização dos campos geográficos. 
 

O que é geocodificação e como funciona?

A geocodificação é o processo de obter texto de entrada, como um endereço, e retornar uma latitude e uma longitude, que podem ser usadas para traçar a localização na superfície da Terra.

O Salesforce Maps depende da interação com um serviço de geocodificação por meio de uma API. Os endereços são enviados ao geocodificador, que determina a latitude e a longitude mais precisas para o endereço fornecido e, em seguida, retorna uma resposta.

O Salesforce Maps lida com informações não estruturadas de endereços parciais e completos. Ao geocodificar campos de endereço personalizados, o Maps utiliza os parâmetros de consulta de texto livre em nossas solicitações ao serviço de geocodificação. As solicitações não são estruturadas, o que significa que enviamos uma lista de strings sem designar qual delas representa qual componente de endereço.

As solicitações são enviadas ao serviço de geocodificador no formato abaixo:
https://geocoder.mapanything.io/6.2/geocode.json?searchtext=200 S Mathilda Sunnyvale CA&gen=9

No exemplo acima, o URL é decodificado para mostrar espaços em branco. Os parâmetros de texto de pesquisa são valores de string e são componentes do endereço.
  • 200 = número da rua
  • S Mathilda = nome da rua
  • Sunnyvale = cidade
  • CA = estado

Deve-se observar que as strings passadas na solicitação do geocodificador são construídas de duas maneiras.

Por exemplo:
Ao geocodificar uma camada representada no produto, a string é construída usando vírgulas.
  • 200, S Mathilda, Sunnyvale, CA 94086
Quando a geocodificação é feita em lotes, o endereço é construído e enviado sem vírgulas.
  • 200 S Mathilda Sunnyvale CA 94086


Em geral, quanto mais parâmetros de texto forem passados na solicitação (ou seja, "CA", "94086"), maior será a confiança na qualidade da correspondência.

Nota: em casos raros, os endereços que contêm a palavra "e" podem levar a códigos geográficos imprecisos. Remova isso do endereço ou use o recurso Definir local verificado.

 

Como os campos de endereço padrão e os campos de endereço personalizados do Salesforce são geocodificados?


Campos de endereço padrão
Se você estiver usando o endereço de cobrança da conta ou os endereços de entrega da conta padrão do Salesforce, será necessário usar as regras de integração de dados padrão para geocodificar seus registros e atualizar suas coordenadas sempre que houver uma atualização nos campos de endereço.

Se a organização tiver regras de integração de dados ativas, o data.com geocodificará registros para determinados objetos padrão.
As regras de integração de dados se aplicam somente a:
  • Endereço de cobrança da conta
  • Endereço de entrega da conta
  • Endereço para correspondência de contato
  • Endereço do lead
Para obter mais informações sobre como ativar regras de integração de dados, consulte o artigo em Ativação de regras de integração de dados

Campo de endereço personalizados
Os campos de endereço personalizados são geocodificados pelo Salesforce Maps. Se você estiver usando campos de endereço personalizados para qualquer objeto base, será necessário criar uma automação para limpar a latitude e a longitude de um registro e geocodificá-lo novamente se você atualizar quaisquer campos de endereço desse registro.
 
 

Quais padrões de geocodificação o Salesforce Maps segue?

O Salesforce Maps usa diferentes níveis de cobertura para diferentes países. Para obter informações sobre a cobertura do geocodificador, consulte Cobertura do geocodificador do Salesforce Maps. Essa cobertura é baseada apenas na geocodificação de campos de endereço personalizados.

Em geral, quanto mais detalhado for o endereço fornecido, maior será o potencial de precisão da correspondência. Por trás de cada geocodificador, há um mecanismo de análise que determina a sintaxe correta dos parâmetros enviados a ele, para que o geocodificador possa consultar corretamente o banco de dados. Nesse caso, é uma série de strings de texto.

Como enviamos solicitações de geocodificação não estruturadas, a precisão do resultado pode depender muito do número de parâmetros enviados e da qualidade desses parâmetros.

Usamos os parâmetros de consulta de texto livre em nossas solicitações ao serviço de geocodificação. Isso significa que o mecanismo de análise do geocodificador utiliza os parâmetros da string não estruturada e determina qual é a sintaxe correta do endereço e das consultas de maneira adequada. O geocodificador deve levar em consideração os formatos de endereço corretos para diferentes países. O formato de endereço padrão do Salesforce é o formato de endereço americano.

Revise estes exemplos de parâmetros de consulta de texto livre.
  • 2, first ave, Australia
  • 2, First Avenue, Belfield NSW, Australia
  • 200, S Mathilda, Sunnyvale, CA
  • 360, Pharr Rd NE, Atlanta, GA, 30305
O geocodificador usa as informações para determinar a latitude e a longitude. Quanto mais parâmetros na solicitação, maior o grau de precisão do resultado.

Por exemplo:
  • 2, first ave, Australia
  • 2, First Avenue, Belfield NSW, Australia
O segundo exemplo garante um resultado mais preciso devido à adição de Belfield e Avenue. Sem essas adições, o geocodificador não consegue fornecer resultados precisos, devido aos numerosos endereços na Austrália incluindo 2 First Ave.

É compreensível que, para endereços desconhecidos, talvez seja difícil saber se o formato está correto para um país específico ou determinar o nível de qualidade do endereço. O geocodificador também determina a qual nível ele pode corresponder, com base nos parâmetros fornecidos. Portanto, nesse exemplo, pode haver um número n de 2 First Avenues na Austrália, mas em cidades diferentes. Isso pode resultar em uma correspondência incorreta.

Diferentes países têm diferentes níveis de cobertura, o que pode estar relacionado à correspondência de um endereço com coordenadas. Consulte o artigo Cobertura do geocodificador do Salesforce Maps para obter mais detalhes sobre a cobertura. Há a possibilidade de resultados de latitude/longitude imprecisos, especialmente se a cobertura do país/área não for de cobertura total.
 
 

Qual é a frequência das atualizações?

 
  • O geocodificador é atualizado trimestralmente.
  • As alterações enviadas podem levar meses para entrar em vigor, dependendo da data do próximo lançamento trimestral. Os endereços para novas construções também podem levar meses para serem refletidos na produção. Isso ocorre porque nosso serviço de geocodificação é auto-hospedado e nosso fornecedor disponibiliza atualizações que consumimos trimestralmente.
 

Quais são as práticas recomendadas para obter uma geocodificação precisa?


1. Se você inserir um nome de cidade comum sem estado ou país, o geocodificador poderá retornar resultados imprecisos.

Por exemplo, sem saber o estado ou o país, o geocodificador poderá fornecer resultados imprecisos para a cidade de Monterrey. Isso porque lugares como Califórnia (EUA), Colômbia e Espanha têm cidades chamadas Monterrey.

2. Evite inserir informações desnecessárias nos campos de endereço.

Se você importar dados de endereço para o Salesforce, alguns de seus registros poderão incluir detalhes adicionais que confundem o geocodificador. Por exemplo:

Attn Finance Director
77 Center Drive
Charlotte, NC 28217

3. Insira o país correto para um endereço.

Por exemplo, o país incorreto neste endereço impede que o geocodificador forneça resultados precisos.

Salesforce Maps
77 Center Drive
Charlotte, NC 28217
Canada

4. Evite entrar no país ou estado várias vezes.

Por exemplo, múltiplas entradas para estado impedem que o geocodificador forneça resultados precisos.

Salesforce Maps
77 Center Drive
Charlotte, NC 28217
North Carolina, USA, US NC 28217

5. Evite traduzir endereços europeus para inglês americano.

Para obter resultados de geocodificação mais precisos, use o endereço local.

Porscheplatz 1
70435 Stuttgart
Deutschland

6. Evite incluir números de apartamentos, suítes e unidades em endereços.

Adicionar essas informações ao campo de endereço pode causar problemas de plotagem no Salesforce Maps. Em vez disso, recomendamos adicionar um número de apartamento, unidade ou suíte em um campo separado nos registros. Por exemplo:

77 Center Drive,
Suite 400,
Charlotte, NC 28217
 
Número do artigo do Knowledge

000380853

 
Carregando
Salesforce Help | Article