使用地理处理示例

地理处理示例是共享地理处理工具和工作流的便捷方式。 地理处理示例是一个 .zip 文件,包含用于在 ArcGIS 中运行地理处理工具的工具箱、脚本、模型、数据和补充文件。 地理处理示例可以是桌面上的本地 .zip 文件,也可以是网络文件夹中的文件。 或者,地理处理示例可以在 ArcGIS OnlineArcGIS Enterprise 门户的我的内容中共享和托管。

您和其他用户可以将地理处理示例中的工具和数据添加到 ArcGIS Pro 工程中,以便查看和使用。

注:

或者,您可能考虑共享和使用地理处理包而非示例。 地理处理包提供了类似的功能,但无需手动合并和压缩包含工具箱和其他文件的文件夹。

创建地理处理示例

工具箱中创建自定义脚本或模型工具后,将所有必要的资源(如工具箱、脚本、数据、文档、工程等)合并到一个可以压缩为 .zip 文件的文件夹中。

注:

确保工具箱中的脚本工具、模型中的数据变量、工程中的图层源和其他源均使用相对路径保存,并将路径更新到已合并文件夹中的位置。 否则,当某用户使用地理处理示例时,可能需要在使用前修复这些资源。

合并示例之后,测试您的模型或脚本工具及其他示例资源,以确保其源设置正确,且工具有效。 另外,为您的自定义工具创建文档,以便其他人易于使用和理解。

建议的文件夹结构和内容

建议您使用以下文件夹结构来合并工具使用的所有源。 合并后,您需将此文件夹压缩到 .zip 文件以创建地理处理示例。

文件夹名称内容描述

<根文件夹>

此文件夹是地理处理示例的根文件夹,包含以下所有文件夹以及具有地理处理工具的工具箱。 此文件夹名称应与预期的示例项目名称和 .zip 文件名称相匹配。

ToolData

包含工具使用的所有数据,包括示例数据。 此文件夹通常包含文件地理数据库、shapefile、栅格、工程和图层文件。

Scripts

包含示例中任何脚本工具的脚本(.py 文件)。

Scratch

此目录可用于在模型中写入中间数据和在脚本中擦除数据。 其中通常包含一个名为 scratch 的地理数据库。 请确保文件夹或地理数据库不包含数据集,否则示例文件将不必要地过大。

Doc

包含帮助用户理解示例的任何支持信息,例如 .pdf 文件、Microsoft Word 文档以及 PowerPoint 演示文稿。

推荐的地理处理示例文件夹结构

创建地理处理示例 .zip 文件

在合并示例资源并测试工具是否有效之后,使用以下步骤创建 .zip 文件:

  1. 文件资源管理器中,浏览到已合并地理处理示例的根文件夹或主文件夹所在的文件夹。
  2. 右键单击根文件夹并选择发送至 > 压缩文件夹。 或者,使用您选择的任何压缩或存档应用程序来创建 .zip 文件。

新的 .zip 文件将位于当前目录中。 如果目录是只读的,将显示对话框以提示您在桌面或用户目录中创建文件。

共享地理处理示例

地理处理示例是可以通过电子邮件、共享文件夹或 Web 页面下载共享的单个 .zip 文件。 它们也是一种受支持的项目类型可上传并托管于 ArcGIS OnlineArcGIS Enterprise 门户中的我的内容中。 使用以下步骤上传地理处理示例:

  1. 在 Web 浏览器中,转到 arcgis.com 或您的 ArcGIS Enterprise 门户主页应用程序。
  2. 使用凭据进行登录。
  3. 在站点顶部,单击内容
  4. 单击新建项目按钮。
  5. 将您的 .zip 文件拖动到放置区或单击您的设备按钮或其他按钮以选择您的 .zip 文件。
  6. 单击项目类型下拉菜单并将类型更改为地理处理示例,然后单击下一步
  7. 输入项目标题、文件夹、标签和摘要,然后单击保存

完成这些步骤后,您将进入地理处理示例的项目详细信息页面,在此可以进一步配置和选择项目的共享选项。 默认情况下,只有您(作为项目所有者)才能访问和下载项目。 单击共享按钮以将共享级别更改为组织所有人(公众)以允许其他用户下载和使用示例。

使用地理处理示例

地理处理示例可包括工具、代码、工程、数据和其他资源,这些资源可能对您试图解决的问题或地理处理工作流十分有用。 根据您获取地理处理示例的方式,可决定如何进行使用。

  • 本地 .zip 文件
  • 托管地理处理示例项目

本地 .zip 文件

要使用之前已下载或复制到计算机文件夹或网络文件夹中的地理处理示例,请执行以下步骤:

  1. 文件资源管理器中,浏览到 .zip 文件所在的位置。
  2. 右键单击 .zip,然后选择全部提取以提取内容。
  3. ArcGIS Pro 中,将提取的文件夹连接到您的工程。

在已连接的文件夹中,您可以看到目录中支持的所有示例资源,包括工具箱和工具、地理数据库等。

托管地理处理示例项目

要使用 ArcGIS OnlineArcGIS Enterprise 门户中托管的地理处理示例,请按照以下步骤操作。

注:

以下步骤适用于代码示例和地理处理示例。

  1. ArcGIS Pro登录并激活门户
  2. 门户中搜索要使用的地理处理示例项目。
  3. 或者,将搜索结果过滤项目类型:工具使查找地理处理示例变得更容易。
  4. 找到要使用的项目后,右键单击并选择添加到工程
    包含“添加到工程”命令的托管地理处理示例项目

将托管地理处理示例添加到工程将执行以下操作:

  • 下载选项中定义的其他包和文件设置的下载位置下载并解压缩地理处理示例 .zip 文件。 提取后,将删除 .zip 文件。
  • 将任意工具箱添加到工程的工具箱
  • 添加到已解压文件夹根目录的文件夹连接。

添加到工程的工具箱中的工具可以在工程的工具箱结点中找到,也可以在地理处理窗格中搜索工具