创建位置分配分析图层 (Network Analyst 工具)

汇总

创建位置分配网络分析图层并设置其分析属性。位置分配分析图层对于从一组可能位置中选择指定数量的设施点（以便以最佳且高效的方式将需求点分配给设施点）十分有用。该图层可通过本地网络数据集进行创建，也可通过在线托管服务或门户托管服务进行创建。

用法

该工具通常用作网络分析工作流的第一步。图层创建后，您可以使用添加位置工具将输入添加到图层，并使用求解工具求解分析。

了解有关网络分析图层工作流的详细信息
当使用 ArcGIS Online 或使用 ArcGIS Online 配置路径服务的 ArcGIS Enterprise 门户作为输入网络数据源时，解决分析将消耗配额并受到某些限制，例如允许的输入数量。

了解关于网络分析中配额消耗和分析限制的详细信息
默认情况下，将在当前工作空间地理处理环境（通常为工程地理数据库）中新建的、自动命名的要素数据集中创建新分析图层的数据。将在相同地理数据库的根级别创建基于表的数据，因为无法将表存储在要素数据集中。可以使用分析地理数据库和分析要素数据集名称参数来覆盖此行为。
虽然该工具可以在 Python 脚本中使用，但在 Python 中执行网络分析的最佳实践是使用 arcpy.nax 模块中的求解程序类。

了解有关在 Python 中执行网络分析的详细信息。

标注	说明	数据类型
网络数据源	将对其执行网络分析的网络数据集或服务。可以使用以下值来指定该参数：网络数据集的目录路径。网络数据集图层已使用标准路由服务配置了 ArcGIS Online 或 ArcGIS Enterprise 门户的 URL 要使用门户 URL，您必须使用具有路径选择权限的账户登录门户。了解有关使用路径服务的网络分析详细信息当使用 ArcGIS Online 或使用 ArcGIS Online 配置路径服务的 ArcGIS Enterprise 门户作为输入网络时，解决分析将消耗配额并受到某些限制，例如允许的输入数量。了解关于网络分析中配额消耗和分析限制的详细信息	Network Dataset Layer; String
图层名称（可选）	将创建的网络分析图层的名称。	String
出行模式（可选）	要在分析中使用的出行模式名称。出行模式为一组网络设置（例如行驶限制和 U 形转弯策略），用于确定行人、汽车、卡车或其他交通媒介在网络中的移动方式。出行模式在网络数据源中进行定义。 `arcpy.na.TravelMode` 对象和包含出行模式有效 JSON 表示的字符串也可用作此参数的输入。	String
行驶方向（可选）	指定计算网络成本时设施点与请求点之间的行驶方向。出行方向会影响具有单向限制和根据方向不同阻抗不同的网络上的请求点到设施点的分配。例如，从请求点驾车到达设施点可能需要 15 分钟，但从设施点驾车行驶至请求点仅需 10 分钟。远离设施点—行驶方向是从请求点指向设施点。这是默认设置。消防部门通常使用该设置，因为他们需要关注从消防站行驶到紧急救援位置所需的时间。朝向设施点—行驶方向从请求点到设施点。零售店通常使用该设置，因为他们需要关注购物者到达商店所需的时间。	String
问题类型（可选）	将要求解的问题的类型。问题类型的选择取决于要定位的设施点种类。不同种类的设施点具有不同的优先级和约束。最小化阻抗—此选项可解决仓库位置问题。它选择一组设施点以使加权阻抗（请求的位置乘以到最近设施点的阻抗）的总和最小。此问题类型通常称为 P 中位数问题。此为默认问题类型。最大化覆盖范围—此选项可解决消防站位置问题。它选择了多个设施点以保证所有或最大数量的请求点处于指定的阻抗中断范围内。最大化具有容量限制的覆盖范围—此选项用于求解容量有限的设施点的位置问题。此选项将选择一组设施点以满足所有或最大数量的请求而不超出任何设施点容量。除了支持容量外，该选项还将选择一组设施点以使加权阻抗（分配给某个设施点的请求点乘以到该设施点的阻抗）的总和最小。最小化设施点数—此选项可解决消防站位置问题。它将选择当在指定的阻抗中断范围内覆盖了所有或最大数量的请求点时所需要的设施点的最小数量。最大化人流量—此选项可解决邻域存储位置问题，其中分配给最近所选设施点的请求比例将随距离的增加而降低。已选择最大化总分配请求点的设施点集。大于指定的阻抗中断的请求点不会影响所选的设施点集。最大化市场份额—此选项可解决竞争性设施点的位置问题。它选择当存在竞争性设施点时可最大化市场份额的设施点。重力模型概念用于确定分配给每个设施点的请求点比例。已选择最大化总分配请求点的设施点集。目标市场份额—此选项可解决竞争性设施点的位置问题。它将选择当存在竞争性设施点时可达到指定目标市场份额的设施点。重力模型概念用于确定分配给每个设施点的请求点比例。已选择的最小设施点量需达到指定的目标市场份额。	String
中断（可选）	以指定出行模式值所使用的阻抗属性单位表示的，请求点可被分配给设施点的最大阻抗。最大阻抗以沿网络的最小成本路径进行测量。如果请求点位于中断外，则不会被分配。此参数可用于对人们为前往商店而愿意行进的最大距离，以及消防站到达社区中任一请求点所允许的最大时间进行建模。可通过在 `Cutoff_`[阻抗] 属性中指定请求点子图层中的单个中断值来逐个请求点覆盖中断值。例如，它可能显示乡村居民愿意走 10 英里远去往某个设施点，而城市居民则只愿意走 2 英里的路程。可按如下方式对此行为进行建模：将分析图层的中断值设置为 10 并将城区中各请求点的 `Cutoff_Miles` 值设置为 2。默认情况下分析不使用中断值。	Double
要查找的设施点数（可选）	求解程序将查找的设施点数。默认值为 1。如果要查找的设施点数量大于必需的设施点，解决方案中将始终包含 `FacilityType` 值为必需的设施点；将从候选设施点中选取要选择的所有多余设施点。任何在求解前 `FacilityType` 值为已选定的设施点，在求解时均视为候选设施点。对于最小化设施点数问题类型，不会考虑此参数值，因为求解程序会搜索要定位的最少设施点数，以最大化覆盖范围。对于目标市场份额问题类型，会覆盖此参数值，因为求解程序会搜索要占有指定市场份额所需的最小设施点数。	Long
衰减函数类型（可选）	此方程可用于对设施点与请求点间网络成本进行变换。此参数与衰减函数参数值参数结合使用，可指定设施点与请求点间的网络阻抗对求解程序选择设施点的影响的严重程度。如果设置请求点的 `ImpedanceTransformation` 属性，则该属性会逐个请求点覆盖分析图层的衰减函数参数值参数。这时，您可能要针对城镇居民和乡村居民使用不同的衰减函数。可通过为分析图层设置阻抗变换以匹配乡村居民的衰减函数，同时为城镇地区中的各个请求点设置阻抗变换以匹配城镇居民的衰减函数，来执行建模。线性—设施点和请求点之间变换的网络阻抗与它们之间的最短路径网络阻抗相同。使用此选项，阻抗参数始终设置为 1。这是默认设置。幂—设施点和请求点之间变换的网络阻抗等于以最短路径网络阻抗为底，以阻抗参数所指定的数为指数的幂运算结果。将此选项与正阻抗参数结合使用可对附近的设施点指定较高的权重。指数—设施点和请求点之间变换的网络阻抗等于以数学常量 e 为底，以最短路径网络阻抗所指定的数为指数的幂乘以阻抗参数。将此选项与正阻抗参数结合使用可对附近的设施点指定很高的权重。指数变化通常与阻抗中断结合使用。	String
衰减函数参数值（可选）	衰减函数类型参数中指定的方程的参数值。当将衰减函数类型参数设置为线性时，会忽略参数值。对于幂和指数选项，应设置非零值。如果设置请求点的 `ImpedanceTransformation` 属性，则该属性会逐个请求点覆盖分析图层的衰减函数参数值参数。这时，您可能要针对城镇居民和乡村居民使用不同的衰减函数。可通过为分析图层设置阻抗变换以匹配乡村居民的衰减函数，同时为城镇地区中的各个请求点设置阻抗变换以匹配城镇居民的衰减函数，来执行建模。	Double
目标市场份额（可选）	当问题类型参数设置为目标市场份额时，要求解的目标市场份额（百分比）。此为您希望求解的设施点占总请求权重的百分比。求解程序会求出为占有该值指定的目标市场份额所需的最小设施点数。	Double
容量（可选）	将问题类型参数设置为最大化具有容量限制的覆盖范围时默认的设施点容量。对于所有其他问题类型，可忽略此参数。设施点有 `Capacity` 属性，如果此属性设置为非空值，将覆盖该设施点的容量参数值。	Double
时间（可选）	出发的时间和日期。出发时间可以来自设施点或请求点，具体取决于行驶方向设置为朝向设施点还是远离设施点。如果您选择基于流量的阻抗属性，将会根据特定的某天某时的动态交通状况来生成解决方案。日期和时间可被指定为 5/14/2012 10:30 AM。将分析配置为使用以下特殊日期之一以针对一周中的某天或当前日期建模（而非使用特定静态日期）： Today—12/30/1899 Sunday—12/31/1899 Monday—1/1/1900 Tuesday—1/2/1900 Wednesday—1/3/1900 Thursday—1/4/1900 Friday—1/5/1900 Saturday—1/6/1900 了解有关如何在网络分析中使用和解释日期和时间的详细信息	Date
时区（可选）	时间参数的时区。各位置的本地时间—时间参数是指设施点或请求点所处的时区。如果出行方向是从设施点到请求点，此为设施点所处的时区。如果出行方向是从请求点到设施点，此为请求点所处的时区。这是默认设置。 UTC—时间参数指协调世界时间 (UTC)。如果您需要在指定时间内（如现在）的最佳位置，但不确定设施点或请求点所在的时区，请选择此选项。	String
线状（可选）	指定输出线形状。无论指定的输出形状类型为何，最佳路径始终由网络阻抗（而非欧氏距离）决定。这表示只是路径形状不同，而对网络进行的基础遍历则相同。无线—将不会为分析的输出生成任何形状。如果您想求解超大型问题，并且仅对解决方案表感兴趣而不想查看地图中的结果，则此选项十分有用。直线—输出线形状是对设施点及其分配的请求点进行连接的直线。这是默认设置。	String
累积属性（可选）	分析过程中要累积的成本属性的列表。这些累积属性仅供参考；求解程序仅使用求解分析时指定的出行模式所使用的成本属性。对于每个累积的成本属性，会在网络分析输出要素中填充 `Total_`[阻抗] 属性。如果网络数据源为 ArcGIS Online 服务或不支持累积的 Portal for ArcGIS 版本上的服务，则此参数不可用。	String
在求解时忽略无效的位置（可选）	指定是否忽略无效的输入位置。通常，如果无法在网络上定位，则位置无效。当无效位置被忽略时，求解程序将跳过它们并尝试使用剩余位置执行分析。选中—将忽略无效输入位置并仅使用有效位置。这是默认设置。未选中—将使用所有输入位置。无效位置将导致分析失败。	Boolean
分析地理数据库（可选）	存储新网络分析图层的子图层的文件地理数据库工作空间。当未指定此参数时，将在当前工作空间地理处理环境（通常为工程地理数据库）中创建子图层的数据。了解有关网络分析图层的分析数据源的详细信息	Workspace
分析要素数据集名称（可选）	用于命名该工具将在分析地理数据库中创建的新要素数据集的名称，该数据集将用于存储网络分析图层的子图层数据。如未指定，要素数据集将以随机唯一名称创建。了解有关网络分析图层的分析数据源的详细信息	String

派生输出

标注	说明	数据类型
网络分析图层	新创建的网络分析图层。	Network Analyst Layer

arcpy.na.MakeLocationAllocationAnalysisLayer(network_data_source, {layer_name}, {travel_mode}, {travel_direction}, {problem_type}, {cutoff}, {number_of_facilities_to_find}, {decay_function_type}, {decay_function_parameter_value}, {target_market_share}, {capacity}, {time_of_day}, {time_zone}, {line_shape}, {accumulate_attributes}, {ignore_invalid_locations}, {analysis_geodatabase}, {analysis_feature_dataset_name})

名称	说明	数据类型
network_data_source	将对其执行网络分析的网络数据集或服务。可以使用以下值之一来指定该参数：网络数据集的目录路径网络数据集图层对象网络数据集图层的字符串名称已使用标准路由服务配置了 ArcGIS Online 或 ArcGIS Enterprise 门户的 URL 要使用门户 URL，您必须使用具有路径选择权限的账户登录门户。了解如何在 Python 中登录门户了解有关使用路径服务的网络分析详细信息当使用 ArcGIS Online 或使用 ArcGIS Online 配置路径服务的 ArcGIS Enterprise 门户作为输入网络时，解决分析将消耗配额并受到某些限制，例如允许的输入数量。了解关于网络分析中配额消耗和分析限制的详细信息	Network Dataset Layer; String
layer_name （可选）	将创建的网络分析图层的名称。	String
travel_mode （可选）	要在分析中使用的出行模式名称。出行模式为一组网络设置（例如行驶限制和 U 形转弯策略），用于确定行人、汽车、卡车或其他交通媒介在网络中的移动方式。出行模式在网络数据源中进行定义。 `arcpy.na.TravelMode` 对象和包含出行模式有效 JSON 表示的字符串也可用作此参数的输入。	String
travel_direction （可选）	指定计算网络成本时设施点与请求点之间的行驶方向。出行方向会影响具有单向限制和根据方向不同阻抗不同的网络上的请求点到设施点的分配。例如，从请求点驾车到达设施点可能需要 15 分钟，但从设施点驾车行驶至请求点仅需 10 分钟。 `FROM_FACILITIES`—行驶方向是从请求点指向设施点。这是默认设置。消防部门通常使用该设置，因为他们需要关注从消防站行驶到紧急救援位置所需的时间。 `TO_FACILITIES`—行驶方向从请求点到设施点。零售店通常使用该设置，因为他们需要关注购物者到达商店所需的时间。	String
problem_type （可选）	将要求解的问题的类型。问题类型的选择取决于要定位的设施点种类。不同种类的设施点具有不同的优先级和约束。 `MINIMIZE_IMPEDANCE`—此选项可解决仓库位置问题。它选择一组设施点以使加权阻抗（请求的位置乘以到最近设施点的阻抗）的总和最小。此问题类型通常称为 P 中位数问题。此为默认问题类型。 `MAXIMIZE_COVERAGE`—此选项可解决消防站位置问题。它选择了多个设施点以保证所有或最大数量的请求点处于指定的阻抗中断范围内。 `MAXIMIZE_CAPACITATED_COVERAGE`—此选项用于求解容量有限的设施点的位置问题。此选项将选择一组设施点以满足所有或最大数量的请求而不超出任何设施点容量。除了支持容量外，该选项还将选择一组设施点以使加权阻抗（分配给某个设施点的请求点乘以到该设施点的阻抗）的总和最小。 `MINIMIZE_FACILITIES`—此选项可解决消防站位置问题。它将选择当在指定的阻抗中断范围内覆盖了所有或最大数量的请求点时所需要的设施点的最小数量。 `MAXIMIZE_ATTENDANCE`—此选项可解决邻域存储位置问题，其中分配给最近所选设施点的请求比例将随距离的增加而降低。已选择最大化总分配请求点的设施点集。大于指定的阻抗中断的请求点不会影响所选的设施点集。 `MAXIMIZE_MARKET_SHARE`—此选项可解决竞争性设施点的位置问题。它选择当存在竞争性设施点时可最大化市场份额的设施点。重力模型概念用于确定分配给每个设施点的请求点比例。已选择最大化总分配请求点的设施点集。 `TARGET_MARKET_SHARE`—此选项可解决竞争性设施点的位置问题。它将选择当存在竞争性设施点时可达到指定目标市场份额的设施点。重力模型概念用于确定分配给每个设施点的请求点比例。已选择的最小设施点量需达到指定的目标市场份额。	String
cutoff （可选）	以指定出行模式值所使用的阻抗属性单位表示的，请求点可被分配给设施点的最大阻抗。最大阻抗以沿网络的最小成本路径进行测量。如果请求点位于中断外，则不会被分配。此参数可用于对人们为前往商店而愿意行进的最大距离，以及消防站到达社区中任一请求点所允许的最大时间进行建模。可通过在 `Cutoff_`[阻抗] 属性中指定请求点子图层中的单个中断值来逐个请求点覆盖中断值。例如，它可能显示乡村居民愿意走 10 英里远去往某个设施点，而城市居民则只愿意走 2 英里的路程。可按如下方式对此行为进行建模：将分析图层的中断值设置为 10 并将城区中各请求点的 `Cutoff_Miles` 值设置为 2。默认情况下分析不使用中断值。	Double
number_of_facilities_to_find （可选）	求解程序将查找的设施点数。默认值为 1。如果要查找的设施点数量大于必需的设施点，解决方案中将始终包含 `FacilityType` 值为必需的设施点；将从候选设施点中选取要选择的所有多余设施点。任何在求解前 `FacilityType` 值为已选定的设施点，在求解时均视为候选设施点。对于 `MINIMIZE_FACILITIES` 问题类型不会考虑此参数值，因为求解程序会搜索最小的设施点数来查找最大的覆盖范围。对于 `TARGET_MARKET_SHARE` 问题类型，会覆盖此参数值，因为求解程序会搜索要占有指定市场份额所需的最小设施点数。	Long
decay_function_type （可选）	此方程可用于对设施点与请求点间网络成本进行变换。此参数与衰减函数参数值参数结合使用，可指定设施点与请求点间的网络阻抗对求解程序选择设施点的影响的严重程度。如果设置请求点的 `ImpedanceTransformation` 属性，则该属性会逐个请求点覆盖分析图层的衰减函数参数值参数。这时，您可能要针对城镇居民和乡村居民使用不同的衰减函数。可通过为分析图层设置阻抗变换以匹配乡村居民的衰减函数，同时为城镇地区中的各个请求点设置阻抗变换以匹配城镇居民的衰减函数，来执行建模。 `LINEAR`—设施点和请求点之间变换的网络阻抗与它们之间的最短路径网络阻抗相同。使用此选项，阻抗参数始终设置为 1。这是默认设置。 `POWER`—设施点和请求点之间变换的网络阻抗等于以最短路径网络阻抗为底，以阻抗参数所指定的数为指数的幂运算结果。将此选项与正阻抗参数结合使用可对附近的设施点指定较高的权重。 `EXPONENTIAL`—设施点和请求点之间变换的网络阻抗等于以数学常量 e 为底，以最短路径网络阻抗所指定的数为指数的幂乘以阻抗参数。将此选项与正阻抗参数结合使用可对附近的设施点指定很高的权重。指数变化通常与阻抗中断结合使用。	String
decay_function_parameter_value （可选）	`decay_function_type` 参数中指定的方程的参数值。当 `decay_function_type` 参数已设置为 `LINEAR` 时，将忽略该参数值。对于 `POWER` 和 `EXPONENTIAL` 选项，应设置非零值。如果设置请求点的 `ImpedanceTransformation` 属性，则该属性会逐个请求点覆盖分析图层的 `decay_function_parameter_value` 参数。这时，您可能要针对城镇居民和乡村居民使用不同的衰减函数。可通过为分析图层设置阻抗变换以匹配乡村居民的衰减函数，同时为城镇地区中的各个请求点设置阻抗变换以匹配城镇居民的衰减函数，来执行建模。	Double
target_market_share （可选）	当 `problem_type` 参数设置为 `TARGET_MARKET_SHARE` 时，要求解的目标市场份额（百分比）。此为您希望求解的设施点占总请求权重的百分比。求解程序会求出为占有该值指定的目标市场份额所需的最小设施点数。	Double
capacity （可选）	将 `problem_type` 参数设为 `MAXIMIZE_CAPACITATED_COVERAGE` 时默认的设施点容量。对于所有其他问题类型，可忽略此参数。设施点有 `Capacity` 属性，如果此属性设置为非空值，将覆盖该设施点的 `capacity` 参数值。	Double
time_of_day （可选）	出发的时间和日期。出发时间可以来自设施点或请求点，具体取决于 `travel_direction` 设置为 `TO_FACILITIES` 还是 `FROM_FACILITIES`。如果您选择基于流量的阻抗属性，将会根据特定的某天某时的动态交通状况来生成解决方案。日期和时间可被指定为 5/14/2012 10:30 AM。将分析配置为使用以下特殊日期之一以针对一周中的某天或当前日期建模（而非使用特定静态日期）： Today—12/30/1899 Sunday—12/31/1899 Monday—1/1/1900 Tuesday—1/2/1900 Wednesday—1/3/1900 Thursday—1/4/1900 Friday—1/5/1900 Saturday—1/6/1900 了解有关如何在网络分析中使用和解释日期和时间的详细信息	Date
time_zone （可选）	时间参数的时区。 `LOCAL_TIME_AT_LOCATIONS`—时间参数是指设施点或请求点所处的时区。如果出行方向是从设施点到请求点，此为设施点所处的时区。如果出行方向是从请求点到设施点，此为请求点所处的时区。这是默认设置。 `UTC`—时间参数指协调世界时间 (UTC)。如果您需要在指定时间内（如现在）的最佳位置，但不确定设施点或请求点所在的时区，请选择此选项。	String
line_shape （可选）	指定输出线形状。无论指定的输出形状类型为何，最佳路径始终由网络阻抗（而非欧氏距离）决定。这表示只是路径形状不同，而对网络进行的基础遍历则相同。 `NO_LINES`—将不会为分析的输出生成任何形状。如果您想求解超大型问题，并且仅对解决方案表感兴趣而不想查看地图中的结果，则此选项十分有用。 `STRAIGHT_LINES`—输出线形状是对设施点及其分配的请求点进行连接的直线。这是默认设置。	String
accumulate_attributes [accumulate_attributes,...] （可选）	分析过程中要累积的成本属性的列表。这些累积属性仅供参考；求解程序仅使用求解分析时指定的出行模式所使用的成本属性。对于每个累积的成本属性，会在网络分析输出要素中填充 `Total_`[阻抗] 属性。如果网络数据源为 ArcGIS Online 服务或不支持累积的 Portal for ArcGIS 版本上的服务，则此参数不可用。	String
ignore_invalid_locations （可选）	指定是否忽略无效的输入位置。通常，如果无法在网络上定位，则位置无效。当无效位置被忽略时，求解程序将跳过它们并尝试使用剩余位置执行分析。 `SKIP`—将忽略无效输入位置并仅使用有效位置。这是默认设置。 `HALT`—将使用所有输入位置。无效位置将导致分析失败。	Boolean
analysis_geodatabase （可选）	存储新网络分析图层的子图层的文件地理数据库工作空间。当未指定此参数时，将在当前工作空间地理处理环境（通常为工程地理数据库）中创建子图层的数据。了解有关网络分析图层的分析数据源的详细信息	Workspace
analysis_feature_dataset_name （可选）	用于命名该工具将在分析地理数据库中创建的新要素数据集的名称，该数据集将用于存储网络分析图层的子图层数据。如未指定，要素数据集将以随机唯一名称创建。了解有关网络分析图层的分析数据源的详细信息	String

派生输出

名称	说明	数据类型
out_network_analysis_layer	新创建的网络分析图层。	Network Analyst Layer

代码示例

提示：

虽然该工具可以在 Python 脚本中使用，但在 Python 中执行网络分析的最佳实践是使用 arcpy.nax 模块中的求解程序类。了解有关在 Python 中执行网络分析的详细信息。

MakeLocationAllocationAnalysisLayer 示例 1（Python 窗口）

仅使用必需参数运行该工具。

network = "C:/Data/SanFrancisco.gdb/Transportation/Streets_ND"
arcpy.na.MakeLocationAllocationAnalysisLayer(network, "StoreLocations")

MakeLocationAllocationAnalysisLayer 示例 2（Python 窗口）

使用所有参数运行该工具。

network = "C:/Data/SanFrancisco.gdb/Transportation/Streets_ND"
arcpy.na.MakeLocationAllocationAnalysisLayer(network, "NewStores",
                                    "Driving Time", "TO_FACILITIES",
                                    "MAXIMIZE_ATTENDANCE", 3, 5, "POWER", 2, "",
                                    "", "1/1/1900 9:00 AM", "UTC",
                                    "STRAIGHT_LINES", ["TravelTime", "Meters"])

MakeLocationAllocationAnalysisLayer 示例 3（工作流）

以下独立 Python 脚本演示了如何使用 MakeLocationAllocationAnalysisLayer 函数选择将为连锁零售店获得最大业务量的商店位置。

# Name: MakeLocationAllocationAnalysisLayer_Workflow.py
# Description: Choose the store locations that would generate the most business
#              for a retail chain. For this scenario, we will perform the
#              location-Allocation analysis using the maximize attendance
#              problem type.
# Requirements: Network Analyst extension

#Import system modules
import arcpy
from arcpy import env
import os

try:
    #Set environment settings
    output_dir = "C:/Data"
    #The NA layer's data will be saved to the workspace specified here
    env.workspace = os.path.join(output_dir, "Output.gdb")
    env.overwriteOutput = True

    #Set local variables
    input_gdb = "C:/Data/SanFrancisco.gdb"
    network = os.path.join(input_gdb, "Transportation", "Streets_ND")
    layer_name = "NewStoreLocations"
    travel_mode = "Driving Time"
    facilities = os.path.join(input_gdb, "Analysis", "CandidateStores")
    required_facility = os.path.join(input_gdb, "Analysis", "ExistingStore")
    demand_points = os.path.join(input_gdb, "Analysis", "TractCentroids")
    output_layer_file = os.path.join(output_dir, layer_name + ".lyrx")

    #Create a new location-allocation layer. In this case, the demand travels to
    #the facility. We wish to find 3 potential store locations out of all the
    #candidate store locations using the maximize attendance model.
    result_object = arcpy.na.MakeLocationAllocationAnalysisLayer(network,
                                    layer_name, travel_mode, "TO_FACILITIES",
                                    "MAXIMIZE_ATTENDANCE", cutoff=20,
                                    number_of_facilities_to_find=3)

    #Get the layer object from the result object. The location-allocation layer
    #can now be referenced using the layer object.
    layer_object = result_object.getOutput(0)

    #Get the names of all the sublayers within the location-allocation layer.
    sublayer_names = arcpy.na.GetNAClassNames(layer_object)
    #Stores the layer names that we will use later
    facilities_layer_name = sublayer_names["Facilities"]
    demand_points_layer_name = sublayer_names["DemandPoints"]

    #Load the candidate store locations as facilities using default search
    #tolerance and field mappings.
    arcpy.na.AddLocations(layer_object, facilities_layer_name, facilities, "",
                                                                            "")

    #Load the existing store location as the required facility. Use the field
    #mappings to set the facility type to requried. We need to append this
    #required facility to existing facilities.
    field_mappings = arcpy.na.NAClassFieldMappings(layer_object,
                                                    facilities_layer_name)
    field_mappings["FacilityType"].defaultValue = 1
    arcpy.na.AddLocations(layer_object, facilities_layer_name,
                            required_facility, field_mappings, "",
                            append="APPEND")

    #Load the tract centroids as demand points using default search tolerance
    #Use the field mappings to map the Weight property from POP2000 field.
    demand_field_mappings = arcpy.na.NAClassFieldMappings(layer_object,
                                                    demand_points_layer_name)
    demand_field_mappings["Weight"].mappedFieldName = "POP2000"
    arcpy.na.AddLocations(layer_object, demand_points_layer_name, demand_points,
                          demand_field_mappings, "")

    #Solve the location-allocation layer
    arcpy.na.Solve(layer_object)

    #Save the solved location-allocation layer as a layer file on disk
    layer_object.saveACopy(output_layer_file)

    print("Script completed successfully")

except Exception as e:
    # If an error occurred, print line number and error message
    import traceback, sys
    tb = sys.exc_info()[2]
    print("An error occurred on line %i" % tb.tb_lineno)
    print(str(e))

环境

当前工作空间

许可信息

基本: 是
标准: 是
高级: 是

标注	说明	数据类型
网络数据源	将对其执行网络分析的网络数据集或服务。可以使用以下值来指定该参数：网络数据集的目录路径。网络数据集图层已使用标准路由服务配置了 ArcGIS Online 或 ArcGIS Enterprise 门户的 URL 要使用门户 URL，您必须使用具有路径选择权限的账户登录门户。了解有关使用路径服务的网络分析详细信息当使用 ArcGIS Online 或使用 ArcGIS Online 配置路径服务的 ArcGIS Enterprise 门户作为输入网络时，解决分析将消耗配额并受到某些限制，例如允许的输入数量。了解关于网络分析中配额消耗和分析限制的详细信息	Network Dataset Layer; String
图层名称（可选）	将创建的网络分析图层的名称。	String
出行模式（可选）	要在分析中使用的出行模式名称。出行模式为一组网络设置（例如行驶限制和 U 形转弯策略），用于确定行人、汽车、卡车或其他交通媒介在网络中的移动方式。出行模式在网络数据源中进行定义。 `arcpy.na.TravelMode` 对象和包含出行模式有效 JSON 表示的字符串也可用作此参数的输入。	String
行驶方向（可选）	指定计算网络成本时设施点与请求点之间的行驶方向。出行方向会影响具有单向限制和根据方向不同阻抗不同的网络上的请求点到设施点的分配。例如，从请求点驾车到达设施点可能需要 15 分钟，但从设施点驾车行驶至请求点仅需 10 分钟。远离设施点—行驶方向是从请求点指向设施点。这是默认设置。消防部门通常使用该设置，因为他们需要关注从消防站行驶到紧急救援位置所需的时间。朝向设施点—行驶方向从请求点到设施点。零售店通常使用该设置，因为他们需要关注购物者到达商店所需的时间。	String
问题类型（可选）	将要求解的问题的类型。问题类型的选择取决于要定位的设施点种类。不同种类的设施点具有不同的优先级和约束。最小化阻抗—此选项可解决仓库位置问题。它选择一组设施点以使加权阻抗（请求的位置乘以到最近设施点的阻抗）的总和最小。此问题类型通常称为 P 中位数问题。此为默认问题类型。最大化覆盖范围—此选项可解决消防站位置问题。它选择了多个设施点以保证所有或最大数量的请求点处于指定的阻抗中断范围内。最大化具有容量限制的覆盖范围—此选项用于求解容量有限的设施点的位置问题。此选项将选择一组设施点以满足所有或最大数量的请求而不超出任何设施点容量。除了支持容量外，该选项还将选择一组设施点以使加权阻抗（分配给某个设施点的请求点乘以到该设施点的阻抗）的总和最小。最小化设施点数—此选项可解决消防站位置问题。它将选择当在指定的阻抗中断范围内覆盖了所有或最大数量的请求点时所需要的设施点的最小数量。最大化人流量—此选项可解决邻域存储位置问题，其中分配给最近所选设施点的请求比例将随距离的增加而降低。已选择最大化总分配请求点的设施点集。大于指定的阻抗中断的请求点不会影响所选的设施点集。最大化市场份额—此选项可解决竞争性设施点的位置问题。它选择当存在竞争性设施点时可最大化市场份额的设施点。重力模型概念用于确定分配给每个设施点的请求点比例。已选择最大化总分配请求点的设施点集。目标市场份额—此选项可解决竞争性设施点的位置问题。它将选择当存在竞争性设施点时可达到指定目标市场份额的设施点。重力模型概念用于确定分配给每个设施点的请求点比例。已选择的最小设施点量需达到指定的目标市场份额。	String
中断（可选）	以指定出行模式值所使用的阻抗属性单位表示的，请求点可被分配给设施点的最大阻抗。最大阻抗以沿网络的最小成本路径进行测量。如果请求点位于中断外，则不会被分配。此参数可用于对人们为前往商店而愿意行进的最大距离，以及消防站到达社区中任一请求点所允许的最大时间进行建模。可通过在 `Cutoff_`[阻抗] 属性中指定请求点子图层中的单个中断值来逐个请求点覆盖中断值。例如，它可能显示乡村居民愿意走 10 英里远去往某个设施点，而城市居民则只愿意走 2 英里的路程。可按如下方式对此行为进行建模：将分析图层的中断值设置为 10 并将城区中各请求点的 `Cutoff_Miles` 值设置为 2。默认情况下分析不使用中断值。	Double
要查找的设施点数（可选）	求解程序将查找的设施点数。默认值为 1。如果要查找的设施点数量大于必需的设施点，解决方案中将始终包含 `FacilityType` 值为必需的设施点；将从候选设施点中选取要选择的所有多余设施点。任何在求解前 `FacilityType` 值为已选定的设施点，在求解时均视为候选设施点。对于最小化设施点数问题类型，不会考虑此参数值，因为求解程序会搜索要定位的最少设施点数，以最大化覆盖范围。对于目标市场份额问题类型，会覆盖此参数值，因为求解程序会搜索要占有指定市场份额所需的最小设施点数。	Long
衰减函数类型（可选）	此方程可用于对设施点与请求点间网络成本进行变换。此参数与衰减函数参数值参数结合使用，可指定设施点与请求点间的网络阻抗对求解程序选择设施点的影响的严重程度。如果设置请求点的 `ImpedanceTransformation` 属性，则该属性会逐个请求点覆盖分析图层的衰减函数参数值参数。这时，您可能要针对城镇居民和乡村居民使用不同的衰减函数。可通过为分析图层设置阻抗变换以匹配乡村居民的衰减函数，同时为城镇地区中的各个请求点设置阻抗变换以匹配城镇居民的衰减函数，来执行建模。线性—设施点和请求点之间变换的网络阻抗与它们之间的最短路径网络阻抗相同。使用此选项，阻抗参数始终设置为 1。这是默认设置。幂—设施点和请求点之间变换的网络阻抗等于以最短路径网络阻抗为底，以阻抗参数所指定的数为指数的幂运算结果。将此选项与正阻抗参数结合使用可对附近的设施点指定较高的权重。指数—设施点和请求点之间变换的网络阻抗等于以数学常量 e 为底，以最短路径网络阻抗所指定的数为指数的幂乘以阻抗参数。将此选项与正阻抗参数结合使用可对附近的设施点指定很高的权重。指数变化通常与阻抗中断结合使用。	String
衰减函数参数值（可选）	衰减函数类型参数中指定的方程的参数值。当将衰减函数类型参数设置为线性时，会忽略参数值。对于幂和指数选项，应设置非零值。如果设置请求点的 `ImpedanceTransformation` 属性，则该属性会逐个请求点覆盖分析图层的衰减函数参数值参数。这时，您可能要针对城镇居民和乡村居民使用不同的衰减函数。可通过为分析图层设置阻抗变换以匹配乡村居民的衰减函数，同时为城镇地区中的各个请求点设置阻抗变换以匹配城镇居民的衰减函数，来执行建模。	Double
目标市场份额（可选）	当问题类型参数设置为目标市场份额时，要求解的目标市场份额（百分比）。此为您希望求解的设施点占总请求权重的百分比。求解程序会求出为占有该值指定的目标市场份额所需的最小设施点数。	Double
容量（可选）	将问题类型参数设置为最大化具有容量限制的覆盖范围时默认的设施点容量。对于所有其他问题类型，可忽略此参数。设施点有 `Capacity` 属性，如果此属性设置为非空值，将覆盖该设施点的容量参数值。	Double
时间（可选）	出发的时间和日期。出发时间可以来自设施点或请求点，具体取决于行驶方向设置为朝向设施点还是远离设施点。如果您选择基于流量的阻抗属性，将会根据特定的某天某时的动态交通状况来生成解决方案。日期和时间可被指定为 5/14/2012 10:30 AM。将分析配置为使用以下特殊日期之一以针对一周中的某天或当前日期建模（而非使用特定静态日期）： Today—12/30/1899 Sunday—12/31/1899 Monday—1/1/1900 Tuesday—1/2/1900 Wednesday—1/3/1900 Thursday—1/4/1900 Friday—1/5/1900 Saturday—1/6/1900 了解有关如何在网络分析中使用和解释日期和时间的详细信息	Date
时区（可选）	时间参数的时区。各位置的本地时间—时间参数是指设施点或请求点所处的时区。如果出行方向是从设施点到请求点，此为设施点所处的时区。如果出行方向是从请求点到设施点，此为请求点所处的时区。这是默认设置。 UTC—时间参数指协调世界时间 (UTC)。如果您需要在指定时间内（如现在）的最佳位置，但不确定设施点或请求点所在的时区，请选择此选项。	String
线状（可选）	指定输出线形状。无论指定的输出形状类型为何，最佳路径始终由网络阻抗（而非欧氏距离）决定。这表示只是路径形状不同，而对网络进行的基础遍历则相同。无线—将不会为分析的输出生成任何形状。如果您想求解超大型问题，并且仅对解决方案表感兴趣而不想查看地图中的结果，则此选项十分有用。直线—输出线形状是对设施点及其分配的请求点进行连接的直线。这是默认设置。	String
累积属性（可选）	分析过程中要累积的成本属性的列表。这些累积属性仅供参考；求解程序仅使用求解分析时指定的出行模式所使用的成本属性。对于每个累积的成本属性，会在网络分析输出要素中填充 `Total_`[阻抗] 属性。如果网络数据源为 ArcGIS Online 服务或不支持累积的 Portal for ArcGIS 版本上的服务，则此参数不可用。	String
在求解时忽略无效的位置（可选）	指定是否忽略无效的输入位置。通常，如果无法在网络上定位，则位置无效。当无效位置被忽略时，求解程序将跳过它们并尝试使用剩余位置执行分析。选中—将忽略无效输入位置并仅使用有效位置。这是默认设置。未选中—将使用所有输入位置。无效位置将导致分析失败。	Boolean
分析地理数据库（可选）	存储新网络分析图层的子图层的文件地理数据库工作空间。当未指定此参数时，将在当前工作空间地理处理环境（通常为工程地理数据库）中创建子图层的数据。了解有关网络分析图层的分析数据源的详细信息	Workspace
分析要素数据集名称（可选）	用于命名该工具将在分析地理数据库中创建的新要素数据集的名称，该数据集将用于存储网络分析图层的子图层数据。如未指定，要素数据集将以随机唯一名称创建。了解有关网络分析图层的分析数据源的详细信息	String

创建位置分配分析图层 (Network Analyst 工具)

汇总

用法

参数

派生输出

环境

许可信息

相关主题