ArcMap

CreateGeocodeSDDraft

摘要

此函数将地址定位器转换为服务定义草稿 (.sddraft) 文件，该文件可用于创建发布地理编码服务的服务定义。

说明

CreateGeocodeSDDraft 是使用 ArcPy 将地址定位器自动发布到地理编码服务的第一步。通过 CreateGeocodeSDDraft 创建的输出是服务定义草稿 (.sddraft) 文件。服务定义草稿由地址定位器属性、服务器信息和一组服务属性组合而成。

服务器信息包括服务器连接、发布到的服务器的类型、服务的元数据（项目信息）和数据参考（是否将数据复制到服务器）。

服务属性包括服务支持的地理编码和反向地理编码等操作、对单个地址进行地理编码时服务返回的最大候选项数量，或者执行地理编码批处理时每个批处理作业中处理的最大记录数。

此函数会返回字典，其中包含应在创建服务定义文件之前解决的错误和其他潜在问题。

可在特定服务器连接信息未知的情况下编写服务定义草稿文件。在这种情况下，可以忽略 connection_file_path 参数；但是必须提供 server_type。可在使用上载服务定义工具发布服务定义草稿文件后提供服务器连接。

语法

CreateGeocodeSDDraft (loc_path, out_sddraft, service_name, {server_type}, {connection_file_path}, {copy_data_to_server}, {folder_name}, {summary}, {tags}, {max_candidates}, {max_batch_size}, {suggested_batch_size}, {supported_operations})
参数说明数据类型
loc_path

表示地址定位器目录路径的字符串。可发布的有效地址定位器格式为文件夹中的定位器文件 (.loc) 或地理数据库中的定位器。

String
out_sddraft

用于表示输出服务定义草稿 (.sddraft) 文件的路径和文件名的字符串。

String
service_name

用于表示服务名称的字符串。该名称用于向用户显示并识别服务。名称只能包含字母数字字符和下划线。不允许使用空格或特殊字符。名称长度不能超过 120 个字符。

String
server_type

表示服务器类型的字符串。如果未提供 connection_file_path 参数，则必须提供 server_type。如果提供了 connection_file_path 参数，则可从连接文件获取 server_type。在这种情况下，您可以选择 FROM_CONNECTION_FILE 或完全跳过该参数。

  • ARCGIS_SERVER —ArcGIS for Server 服务器类型。
  • FROM_CONNECTION_FILE —获取 connection_file_path 参数中所指定的 server_type。

(默认值为 ARCGIS_SERVER)

String
connection_file_path

用于表示 ArcGIS for Server 连接文件 (.ags) 的路径和文件名的字符串。

String
copy_data_to_server

指示地址定位器中所引用的数据是否复制到服务器的布尔值。copy_data_to_server 参数仅在 server_type 为 ARCGIS_SERVER 且 connection_file_path 未指定的情况下使用。如果 connection_file_path 已指定，则会使用服务器的已注册数据存储。例如，如果地址定位器中的数据已注册到服务器，则 copy_data_to_server 将始终为 False。相反，如果地址定位器中的数据未注册到服务器，则 copy_data_to_server 将始终为 True。

(默认值为 False)

Boolean
folder_name

用于表示您要向其中发布服务定义的文件夹名称的字符串。如果文件夹当前不存在，则将在服务定义发布为服务时创建文件夹。默认的文件夹为服务器根级别。

(默认值为 None)

String
summary

用于表示项目描述摘要的字符串。

使用此参数可以覆盖用户界面摘要，如果摘要不存在，则将提供摘要。

(默认值为 None)

String
tags

用于表示项目描述标签的字符串。

使用此参数可以覆盖用户界面标签，如果标签不存在，则将提供标签。要指定多个标签，请在字符串中以逗号分隔各标签。

(默认值为 None)

String
max_candidates

地理编码单个地址时服务返回的最大候选项数。

(默认值为 500)

Integer
max_batch_size

执行批量地理编码时每次批处理作业要处理的最大记录数。

(默认值为 1000)

Integer
suggested_batch_size

执行批量地理编码时每次批处理作业要处理的记录的建议数量。

(默认值为 1000)

Integer
supported_operations
[supported_operations,...]

服务所支持的内置操作。应将参数指定为包含一个或多个下列字符串关键字的列表：

  • GEOCODE - 服务允许地理编码操作。
  • REVERSE_GEOCODE - 服务允许反向地理编码操作。
  • SUGGEST - 服务允许建议操作。

例如，要将服务指定为仅支持地理编码操作而不允许任何其他反向地理编码操作，则需将参数指定为 ["GEOCODE"]。

(默认值为 [GEOCODE, REVERSE_GEOCODE, SUGGEST])

List

返回值

数据类型说明
Dictionary

返回由信息性消息、警告和错误组成的字典。