Loading

Maps 地理编码常见问题解答

发布日期: May 1, 2026
解决方案

以下是关于 Maps 地理编码的常见问题解答列表:


注意:GeoCode 服务为异步服务,更新地理字段可能会有轻微的延迟。 
 

什么是地理编码,它的工作方式如何?

地理编码是获取街道地址等输入文本,并返回纬度和经度的过程,可用于绘制地球表面的位置。

Salesforce Maps 依赖于通过 API 与地理编码服务进行交互。地址被发送给地理编码器,由它确定给定地址最准确的经纬度,然后返回一个响应。

Salesforce Maps 可处理非结构化部分地址和完整地址信息。对自定义地址字段进行地理编码时,Maps 会在向地理编码服务的请求中利用自由文本查询参数。这些请求为非结构化请求,这意味着我们只会发送一个字符串列表,但不会指定哪个字符串代表哪个地址组件。

请求会以下列格式被发送到地理编码器服务:
https://geocoder.mapanything.io/6.2/geocode.json?searchtext=200 S Mathilda Sunnyvale CA&gen=9

在以上示例中,URL 被解码,以显示空白。搜索文本参数是字符串值,是地址的组成部分。
  • 200 = 街道编号
  • S Mathilda = 街道名称
  • Sunnyvale = 城市
  • CA = 州

需要注意的是,地理编码器请求中传入的字符串通过以下两种方式中的一种进行构造。

例如:
对产品中绘制的层进行地理编码时,字符串使用逗号构造。
  • 200, S Mathilda, Sunnyvale, CA 94086
批量完成地理编码时,构造并发送地址时没有逗号。
  • 200 S Mathilda Sunnyvale CA 94086


一般来说,在请求中传递的文本参数越多(如“CA”、“94086”),匹配质量的置信度越高。

注意:在极少数情况下,包含单词“and”的街道地址可能导致地理编码不准确。请将其从街道地址中删除或使用设置经过验证的位置功能。

 

如何对 Salesforce 标准地址字段和自定义地址字段进行地理编码?


标准地址字段
如果您正在使用 Salesforce 的标准客户账单地址或客户送货地址,则应该使用标准数据集成规则对记录进行地理编码,以便在地址字段有更新时更新它们的坐标。

如果组织激活了数据集成规则,data.com 将对某些标准对象的记录进行地理编码。
数据集成规则仅适用于:
  • 客户账单地址
  • 客户送货地址
  • 联系人邮寄地址
  • 潜在客户地址
有关激活数据集成规则的更多信息,请查看关于激活数据集成规则文章

自定义地址字段
自定义地址字段由 Salesforce Maps 进行地理编码。如果您正在为任何基础对象使用自定义地址字段,则应该创建自动化,来清除记录的纬度和经度,并在更新该记录的任何地址字段时重新对其进行地理编码。
 
 

Salesforce Maps 遵循哪些地理编码标准?

Salesforce Maps 会对不同国家/地区使用不同的覆盖范围级别。有关地理编码覆盖范围的信息,请参见 Salesforce Maps 地理编码器覆盖范围。此覆盖范围仅适用于对自定义地址字段进行地理编码。

一般来说,提供的地址越详细,匹配准确的可能性就越高。每个地理编码器背后都有一个解析引擎,用于确定传递给它的参数的语法是否正确,以便正确地查询数据库。在本示例中,它是一系列文本字符串。

因为我们发送的是非结构化地理编码请求,所以结果的准确性在很大程度上取决于发送的参数数量和这些参数的质量。

我们会在向地理编码服务发送的请求中使用自由文本查询参数。这意味着地理编码器的解析引擎接受非结构化字符串参数,并可以确定地址的语法是否正确并进行适当的查询。地理编码器必须考虑不同国家/地区的正确地址格式。Salesforce 默认地址格式是美国地址格式。

查看这些自由文本查询参数的示例。
  • 2, first ave, Australia
  • 2, First Avenue, Belfield NSW, Australia
  • 200, S Mathilda, Sunnyvale, CA
  • 360, Pharr Rd NE, Atlanta, GA, 30305
地理编码器会使用这些信息来确定纬度和经度。请求中的参数越多,结果的准确度越高。

例如:
  • 2, first ave, Australia
  • 2, First Avenue, Belfield NSW, Australia
由于添加了 BelfieldAvenue,因此,第二个示例可以确保得到更准确的结果。如果没有这些添加的信息,地理编码器就无法给出准确的结果,因为澳大利亚有很多地址,包括 2 First Ave

可以理解的是,对于不熟悉的地址,可能很难知道该格式对于给定的国家/地区是否正确,或确定地址的质量水平。地理编码器还可以根据给定的参数确定它可以匹配什么级别。在本示例中,在澳大利亚可能有n2 First Avenues,但在不同的城市。这可能导致匹配不正确。

不同的国家/地区有不同的覆盖水平,这可能与地址与坐标的匹配相关。有关覆盖范围的更多详细信息,请参阅 Salesforce Maps 地理编码器覆盖范围文章。有可能出现不准确的维度/经度结果,特别是如果对国家/地区的覆盖不是完全覆盖。
 
 

更新的频率是多久?

 
  • 地址编码器每季度更新一次。
  • 提交的更改可能需要几个月才能生效,具体时间取决于下一此季度发布的日期。新建筑的地址也可能需要几个月的时间才能反映在生产中。这是因为我们的地理编码服务是自托管服务,我们的供应商会按照每季度的使用为我们提供更新。
 

获得精确地理编码的最佳实践是什么?


1.如果输入的是一个普通的城市名,而没有州或国家/地区,地理编码器可能会返回不准确的结果。

例如,在不知道州或国家/地区的情况下,地理编码器可能会为 Monterrey 市提供不准确的结果。这是因为加州(美国)、哥伦比亚和西班牙都有名称为 Monterrey 的城市。

2.避免在地址栏中输入不必要的信息。

如果将地址数据导入 Salesforce,您的一些记录可能包含一些会导致地理编码器无法理解的额外详细信息。例如:

Attn Finance Director
77 Center Drive
Charlotte, NC 28217

3.在地址中输入正确的国家/地区。

例如,这个地址中不正确的国家/地区会导致地理编码器无法提供准确的结果。

Salesforce Maps
77 Center Drive
Charlotte, NC 28217
Canada

4.避免多次输入国家/地区或州。

例如,输入多个州会导致地理编码器无法提供准确的结果。

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

5.避免将欧洲地址翻译成美国英语。

要获得最准确的地理编码结果,请使用本地地址。

Porscheplatz 1
70435 Stuttgart
Deutschland

6.避免在街道地址中包括楼栋号、房号和单元号。

将这些信息添加到街道地址字段可能会导致 Salesforce Maps 中的绘图问题。我们建议您在记录中的单独字段中添加楼栋号、单元号或房号。例如:

77 Center Drive,
Suite 400,
Charlotte, NC 28217
 
知识文章编号

000380853

 
正在加载
Salesforce Help | Article