地理阳台

例子：创建点几何图形并查找地址列表的坐标

在本例中，一个包含业务列表的电子表格(地址组件分布在一系列列中)被地理编码并输出到KML。

地理编码将使用谷歌服务完成，该服务期望在自由形式的单个属性中看到地址，因此使用attributemanager.。此新属性包含完整的地址，其中包含逗号分隔的组件：

在Geocoder中，选择Google作为服务带来了所需的参数。API键提供身份验证，选择“正向”的默认地理编码模式，并且街道地址设置为新构造的“地址”属性。

扩展GeoCoder上的输出现在显示服务中可用的附加属性 - 其中一些已包含在KML编写器中，如绿色所示。虽然我们已选择将纬度和经度视为属性，但也正在为特征创建点几何（无论信息是否保留为属性），如此。）

结果输出到KML文件中。

输入

此变形器接受任何功能。属性数据将按指定使用以产生地理编码结果。不同的服务将需要不同的属性集。

街道地址地理编码需要单行自由形式地址字符串或离散地址元素（如街道地址，城市等）
IP地址地理编码接受IPv4或IPv6地址，例如199.7.157.0或2001：0DB8：0A0B：12F0：0000：0000：0000：0001。
反向地理编码接受一对纬度/经度属性。

输入特征几何不用作输入。如果需要几何图形的输入，则协调置换器可用于从点几何中提取x和y坐标到该特征上的属性。

输出

当地理编码查找成功时，转换器将输出带有添加的属性和替换的几何图形的特性。可能添加属性:

_地址	一个单行的地址
_address_json	JSON格式的多级地址（如果Geocoder结果字段不可预测）。
_ltate，_Longitude.	纬度，经度
_elevation_meters、_elevation_feet _elevation_resolution	米和英尺的高程，以及高程值的误差范围。
_时区	TimeZone短代码。示例：美国/温哥华
_timezone_name	时区描述。例如:太平洋夏令时
_timezone_offset.	与UTC的偏移量，以秒为单位。可能是消极的，也可能是积极的。
_timezone_current_dst	当前在夏令时的标准时间偏移秒数。通常为0或3600，但其他值是可能的。

请注意，属性可能会根据输入的方式以更正后的形式输出。

例如，供应“7445 132街，萨里，BC”的前向地理编码可能导致输出'_Address'属性值“7445 132 St，Surrey，BC V3W，Canada”。这可以是地址数据标准化的有用结果。

<被拒绝>

导致操作失败操作的功能将通过此端口输出。这可能是由不在地球上的无效地址，纬度/经度坐标引起的，或者在其他原因中丢失或无效的API键。此外，属性'fme_reimpe_code'和'fme_reimpe_message'将包含有关失败的详细信息。原始几何形状被保留。

拒绝功能处理：可以设置为终止翻译或在遇到被拒绝的功能时继续运行。此设置可用作默认设置FME选项和A.工作区参数。

服务

地理编码服务

选择用于对请求进行地理编码的服务。该服务还确定转换器接口中可用的地理编码模式。

一些服务仅支持IP地址，而其他服务支持房屋地址或纬度/经度对。有关可用服务的详细信息，请参阅地理编码服务以下。

联系

在执行地理编码之前，某些提供程序要求用户指定其他凭据，例如API密钥或用户名和密码。还需要自定义URL或允许某些服务。

URL.

URL字段指向备用服务器位置。这通常是在线产品的自主主机版本，通常使用客户自己的数据而不是通用，全球数据集可供公众使用。

API键

某些服务需要使用API密钥，通常通过在服务网站上注册来获得。

需要密钥的服务不能在没有密钥的情况下使用，通常是因为它是付费服务或强制限制。

密钥是可选的服务通常提供比未注册用户更好的性能或更高的密钥限制。

用户名密码

客户/秘密

一些服务要求或允许使用用户名和密码或客户端密钥和秘密进行身份验证，类似于API密钥。

地理编码参数

这是所有服务的可能参数的完整列表。请注意，每个服务都不支持下面列出的每个参数。

模式	如果所选服务支持多种地理编码模式，则可以在此处选择选择;例如，Google服务支持前进，反向，高程和时区模式。如果没有，则始终假设前向地理编码。此选择还确定哪个输入模式变为活动状态。正向地理编码接受街道或IP地址形式的输入，而海拔、反向和时区地理编码接受纬度和经度作为输入。邻近地理编码除了地理编码的地址外，还允许指定纬度和经度;定位是用来得到更准确的结果。
街道地址	对于单行地址，地址元素的逗号分隔列表。例如，123个主要街道，萨里，卑诗省，加拿大。如果需要，可以通过使用文本编辑器将其与变压器中的或使用该字符串从单独的属性构建此字符串attributemanager.在工作空间的前面。请注意，某些服务涉及到地址字符串格式时比其他服务更宽松。对于离散地址元素，街道地址通常仅包含房屋号和街道名称。例如，123个主要街道。这与其他字段一起使用以指定完整地址。
城市	城市的名称，用于离散地址规范。
省/州	离散地址规范的省或州组件的全名或缩写。
邮政/邮政编码	离散地址规范的邮政编码或邮政编码组件。
纬度/经度	纬度经度对的截然不同的值，例如：纬度:49.1044 经度:-122.8011
IP地址	IPv4或IPv6地址。例子： 199.7.157.0，或者 2001:0db8:0a0b: 12 f0:0000:0000:0000:0001
返回的语言	对于某些服务，可以指定用于地理编码结果的语言。这通常适用于校正地理编码的校正地址以及反向地理编码结果地址。例子：反向地理编码52.07,4.28将返回英文“The Hague”(en)，但荷兰语“Den Haag”(nl)。

先进的

超时	用户可以可选地提供该字段中的值以在单个请求上设置最大时间，以秒为单位等待。在指定的时间后，如果请求尚未完成，请求将重试到最多3次尝试。如果它没有成功，则将使用错误代码输出该功能。
最大并发请求	这指定了以并行制作的地理编码请求的数量。请注意，这可能会从地理编码服务产生限制。由于速率限制，GeoCoder将自动等待并将请求重试，以最多3次尝试。

地理编码服务和可用模式

支持以下服务：

服务	模式
ArcGIS在线	向前，反向
ArcGIS 服务	向前，反向
兵	向前，反向
FreeGeoIP.net	IP地址
地理编码。农场	向前，反向
geocoder.ca.	向前，反向
谷歌	正向，反向，海拔，时区
这里	向前，反向
IPInfo.io	IP地址
Mapzen.	向前，反向
奖项	向前，反向
开放地图	向前，反向
TAMU	转发，带有地区普查信息

注意，许多服务都有额外的使用需求。一个常见的需求是在同一个服务的映射中显示结果数据。在数据库中存储结果数据也可能需要额外的费用。请咨询地理编码提供商的服务条款(如下所列)，以确保您的使用符合规定。

地理编码服务提供商信息

ArcGIS在线	要访问此地理编码服务，您需要提供有效的ArcGIS在线访问凭据。联系ESRI设置您自己的ArcGIS在线帐户：http://www.arcgis.com/features/plans/pricing.html.。请注意，使用此Geocoder转换器可能会用光信用，您可能受到交易限制。有关更多信息，请参阅https://developers.arcgis.com/rest/geocode/api -reference/overview-world-geocoding-service.htm.。使用前请查阅服务条款:https://developers.arcgis.com/terms。
ArcGIS 服务	此服务类型在本地ArcGIS Server安装上使用已发布的GeoCoder服务。有关更多信息，请参阅http://server.artes.com/en/server/latest/publish-services/windows/geocode-services.htm.。
兵	要访问此地理编码服务，您需要提供有效的Bing映射访问凭据。联系Microsoft设置自己的Bing地图帐户：https://www.microsoft.com/maps/licensing/licensing.aspx.。请注意，使用此Geocoder转换器可能会用光信用，您可能受到交易限制。使用前请查阅服务条款:https://www.microsoft.com/maps/product/terms.html.。
FreeGeoIP.net	使用此服务时可能会有事务限制。有关更多信息，请参阅：https://freegeoip.net.。
地理编码。农场	要访问此地理编码服务，您需要提供有效的GeoCode.farm访问凭据。联系GeoCode.farm设置您自己的帐户：https://geocode.farm/register.。请注意，使用此服务的Geocoder变压器可能会使用Credit，您可能会受到交易限制。使用前请查阅服务条款:https://geocode.farm/policies/terms-of-service。
geocoder.ca.	要访问这个地理编码服务，您需要提供有效的地理编码器。ca证书的访问。Geocoder联系。建立个人帐户Ca:http://geocoder.ca/?register=1。请注意，使用此服务的Geocoder变压器可能会使用Credit，您可能会受到交易限制。使用前请查阅服务条款：http://geocoder.ca/terms=1。
谷歌	要访问这个地理编码服务，您需要提供一个有效的谷歌Maps地理编码API密钥。联系谷歌建立自己的账号:https://developers.google.com/maps/documentation/geocoding/get-api -key.。请注意，使用此服务的Geocoder变压器可能会使用Credit，您可能会受到交易限制。有关更多信息，请参阅https://developers.google.com/maps/documentation/geocoding/usage-limits.。使用前请查阅服务条款:https://developers.google.com/maps/terms.。重要的：Google地图GeoCoding API只能与Google地图上的显示结果一起使用。禁止使用Google Maps GeoCoding API数据而不显示Google地图。有关更多信息，请参阅：https://developers.google.com/maps/documentation/geocoding/policies.。
这里	要访问此地理编码服务，您需要提供有效的访问凭据。联系此处设置您自己的帐户：https://developer.here.com/plans/api/geocoder。请注意，使用此Geocoder转换器可能会用光信用，您可能受到交易限制。您不允许在此处展示或可视化任何第三方内容（例如地图，街道或卫星图像）的结果。有关使用限制的重要资料，请参阅服务条款:https://developer.here.com/terms-and-conditions.。
IPInfo.io	这个地理编码服务根据您的订阅级别限制了交易量。IPInfo联系。IO开立自己的账户:https://ipinfo.io/pricing.。使用前请查阅服务条款:https://ipinfo.io/developers。
Mapzen.	要访问这个地理编码服务，您需要提供有效的Mapzen访问凭据。联系Mapzen建立你自己的账户:https://mapzen.com/projects/search.。注意，这个地理编码服务受事务限制的限制。使用前请查阅服务条款:https://mapzen.com/terms.。
奖项	要访问此地理编码服务，您需要提供有效的Opencage GeoCoder访问凭据。联系OpenCage数据以设置您自己的帐户：https://geocoder.opencagedata.com/pricing.。请注意，使用此Geocoder转换器可能会用光信用，您可能受到交易限制。使用前请查阅服务条款:https://geocoder.opencagedata.com/terms。
OpenStreetMap（Nominatim）	此服务旨在与自托管的Nominatim服务器一起使用。有关安装NomInatim Server的更多信息可用于：http://wiki.openstreetmap.org/wiki/nominatim/inallation.。要使用您自己的服务器使用GeoCoder，请提供完整的URL。这通常会以“搜索”结束 - 例如，http://nominatim.example.com/search。 OpenStreetMaps的Nominatim Server，同时公开可用，不适合繁重使用，并且有几种使用限制，使其在几乎所有情况下与FME一起使用：http://wiki.openstreetmap.org/wiki/nominatim_usage_policy.。
Tamu（德克萨斯A＆M大学Geoservices）	要访问此地理编码服务，您需要提供有效的访问凭据。联系Texas A＆M Geoservice设置您自己的帐户：http://geboservices.tamu.edu/pricing.。请注意，使用此服务的Geocoder变压器可能会使用Credit，您可能会受到交易限制。使用前请查阅服务条款:http://geoservices.tamu.edu/About/Legal。

如何设置参数值

使用文本编辑器

文本编辑器提供了一种方便的方法来从各种数据源(如属性、参数和常量)构造文本字符串(包括正则表达式)，其中的结果直接在参数中使用。

文本编辑器

使用算术编辑器

算术编辑器提供了一种方便的方法来构建来自各种数据源的数学表达式，例如属性，参数和特征函数，其中结果直接在参数内使用。

算术编辑器

条件值

根据通过或失败的一个或多个测试条件设置值。

参数条件定义对话框

内容

表达式和字符串可以包括许多函数、字符、参数等——无论是直接在参数中输入还是使用某个编辑器构造。

转发街道地址地理编码	单一免费表格街道地址到纬度/经度值，例如： “7445，132nd Street，Surrey，BC，V3W 1J8” 例如，离散的街道地址元素，例如： “7445” “132nd” “街道” “萨里” “公元前” “V3W 1J8”
具有邻近地理编码的街头地址	单一免费形式街道地址和近似纬度/经度到精确的纬度/经度值离散街道地址元素和近似纬度/经度到精确的纬度/经度值
转发IP地址地理编码	IP地址字符串到纬度/经度值
反向街道地址地理编码	纬度/经度值到单个街道地址字符串
反向高程地理编码	纬度/经度值到海拔，单位是米
反向时区地理编码	纬度/经度值到时区代码，名称和偏移量

字符串函数	这些功能操纵和格式化字符串。
特殊的角色	文本编辑器中提供了一组控制字符。
数学函数	两个编辑器都有数学函数。
数学运算符	这些运算符可在算术编辑器中使用。
FME功能功能	这些主要是特定于特征的值。
FME参数	可以使用FME和工作区特定的参数。
使用用户参数	创建自己的可编辑参数。

处理行为	特征为基础
功能持有	不
依赖性	外部地理编码Web服务
FME授权级别	FME专业版及以上
别名
历史	FME 2017.0发布:
类别	一体化网页

典型的使用

它是如何工作的?

使用说明

配置

输入端口

输出端口

参数

地理编码服务

编辑变换器参数

定义值

参考

FME知识中心