摘要
该 ArcGIS Online 服务会在设施点周围确定网络服务区。网络服务区是指包含从一个或多个设施点的给定距离或行程时间之内可到达的所有街道的区域。例如，某一设施点的 10 分钟服务区包含从该设施点出发 10 分钟内可以到达的所有街道。
服务区通常用于显示和测量可达性。例如，杂货店周围三分钟的行驶时间面可以确定能够在三分钟内到达的杂货店以及更有可能在此购物的居民。
插图
用法
如果“中断单位”参数的值设置为时间单位，则工具会创建行驶时间区域。同样，如果“中断单位”为距离单位，工具会创建行驶距离区域。工具可以生成最长 300 分钟或 300 英里（482.80 千米）的服务区。当生成详细面时，最大服务区大小限制为 详细面为 15 分钟和 详细面为 15 英里（24.14 千米）。
为成功执行该工具，您至少需要指定一个设施点。最多可加载 1,000 个设施点。
最多可以添加 250 个点障碍。您可以添加任意数量的线障碍或面障碍，但线障碍的相交数不能超过 500 个街道要素，面障碍的相交数不能超过 2,000 个要素。
求解时可选择使用道路等级以更快地生成结果，但解决方案可能不够精确。
无论是否选中“应用等级”参数 (True)，当最大中断值超过 240 分钟或 240 英里（386.24 千米）时，将始终使用等级。当输出服务区没有重叠或概化时，此限制降低到 15 分钟和 15 英里（24.14 千米）。
如果输入点与其最近的可穿过街道之间的距离大于 12.42 英里（20 千米），则将从分析中排除该点。
此工具可在 ArcGIS Pro、ArcMap、ArcGlobe 和 ArcScene 中运行，但不适用于 ArcCatalog。
语法
GenerateServiceAreas_naagol (Facilities, Break_Values, Break_Units, {Analysis_Region}, Travel_Direction, Time_of_Day, Use_Hierarchy, UTurn_at_Junctions, Polygons_for_Multiple_Facilities, Polygon_Overlap_Type, {Detailed_Polygons}, Polygon_Trim_Distance, Polygon_Simplification_Tolerance, Point_Barriers, {Line_Barriers}, Polygon_Barriers, Restrictions, {Attribute_Parameter_Values}, {Time_Zone_for_Time_of_Day}, {Travel_Mode}, {Impedance}, {Service_Areas}, {Save_Output_Network_Analysis_Layer}, {Overrides})| 参数 | 说明 | 数据类型 |
Facilities | 在其周围生成服务区的设施点。最多可加载 1,000 个设施点。 设施点要素集具有一个关联的属性表。下面列出并说明了属性表中的所有字段。 ObjectID：系统管理的 ID 字段。 Name - 设施点的名称。如果未指定名称，则求解过程中会自动生成一个名称。 当“多个设施点的面”参数设置为“叠置”或“不叠置”时，输入设施点的所有字段都包含在输出面中。输入设备点的 ObjectID 字段会传递到输出面的 FacilityOID 字段中。 | Feature Set |
Break_Values | 指定为每个设施点生成的服务区面的大小和数量。单位由“中断单位”值决定。 可以设置多个面中断来为每个设施点创建同心服务区。例如，要查找每个设施点的 2 英里、3 英里及 5 英里服务区，请输入 2 3 5，各个数值之间用空格进行分隔，将设置“中断单位”设置为“英里”。所指定中断值的数量没有限制。 最大中断值的大小不能超过 300 分钟或 300 英里（482.80 千米）。当生成详细面时，最大服务区大小限制为 详细面为 15 分钟和 详细面为 15 英里（24.14 千米）。 | String |
Break_Units | “中断值”参数的单位。 此参数单位的选择决定了工具通过测量行驶距离还是行驶时间来创建服务区。选择时间单位以测量行驶时间。要测量行驶距离，则请选择距离单位。选择的单位还确定工具在结果中以哪种单位报告总行驶时间或距离。这些单位包括：
| String |
Analysis_Region (可选) | 指定要进行分析的区域。如果未对此参数指定值，工具会基于输入点的位置自动计算区域名称。为加快工具执行，建议设置区域名称。要指定区域，请使用以下值之一：
| String |
Travel_Direction | 指定用于生成服务区面的行程方向是朝向还是远离设施点。
行程方向可以改变面的形状，因为街道两侧的阻抗可能不同，或者可能存在单向约束，例如单行道。方向的选择取决于服务区分析的特性。例如，应该在远离设施点的方向上创建比萨外卖店的服务区，而医院的服务区应该创建在朝向设施点的方向上。 | String |
Time_of_Day | 离开或到达设施点的时间。对该值的解释取决于行驶方向是朝向设施点还是远离设施点。
可以使用时间的时区参数指定该时间和日期是参考 UTC 还是设施点或事件点所在时区。 重复求解相同的分析问题，但使用不同的时间参数值，这样您就会看到设施点的到达时间随时间的变化。例如，消防站周围的五分钟服务区在大清早时可能变得大一点，而在早高峰期消失，上午晚些时候服务区又扩大，并在一天中都保持这样。 | Date |
Use_Hierarchy | 指定是否应在查找设施点和事件点之间的最佳路径时使用等级。
无论是否选中“应用等级”参数 (True)，当最大中断值超过 240 分钟或 240 英里（386.24 千米）时，将始终使用等级。 | Boolean |
UTurn_at_Junctions | 使用此参数限制或允许服务区在交汇点处 U 形转弯。为理解这些参数值，请考虑下列术语：交汇点是在路段的尽头且可能与其他一条或多条路段相连的点；伪交汇点是指两条街道确实在此处相连的点；交叉点是指三条或更多街道在此处相连的点；死角是指一条不与其他路段相连的路段的尽头。鉴于这些信息，参数可能具有以下值：
| String |
Polygons_for_Multiple_Facilities | 选择当分析中存在多个设施点时生成服务区面的方式。
在使用“叠置”或“非叠置”时，输入设施点的所有字段都包含在输出面中（输入 ObjectID 字段中的值传递到输出面的 FacilityOID 字段这种情况除外）。按中断值合并时 FacilityOID 字段为空，输入字段不包含在输出中。 | String |
Polygon_Overlap_Type | 指定该选项，将同心服务区面创建为圆或环。仅当为这些设施点指定多个中断值时，此选项才可用。
| String |
Detailed_Polygons (可选) | 指定是要创建详细面还是概化面。
如果是具有类似格网街道网络的市区设施点，则概化服务区和详细服务区之间的差别最小。然而，如果设施点位于一个包含山区道路和农村道路的区域，则详细服务区可能明显会比概化服务区显示更多的精确结果。 仅当“中断值”参数内指定的最大值小于或等于 详细面为 15 分钟或 详细面为 15 英里（24.14 千米）时，工具支持生成详细面。 | Boolean |
Polygon_Trim_Distance | 指定对服务区面进行修剪的距离范围。当您在街道网络稀疏的地点查找服务区且不需要服务区覆盖大片没有街道要素的区域时，此选项很有用。 默认值是 100 米。此参数没有值或值为 0 时，会指定不应对服务区面进行修剪。使用等级时，将忽略此参数值。 | Linear unit |
Polygon_Simplification_Tolerance | 指定面几何的简化程度。 简化仍将保留面的关键折点，以定义面的基本形状和移除其他折点。所指定的简化距离为简化面边界可偏离原始面边界的最大偏移。对面进行简化将减少折点的数量，并且往往能够减少绘制时间。 | Linear unit |
Point_Barriers | 指定一个或多个点作为临时限制，或显示在基础街道上行驶可能需要的附加时间或距离。例如，点障碍可用来显示一棵沿街倒下的树或是铁路道口上的时间延迟。 工具限制了可添加为障碍的点不得超过 250 个。 指定点障碍后，可通过使用特性为每个事件点设置属性，例如其名称或障碍类型。可通过以下属性指定点障碍： Name：障碍名称。 BarrierType：指定点障碍是完全限制通行还是增加通过障碍时的时间或距离。此特性值可指定为以下整数之一（请使用数值代码而非括号中的名称）：
Additional_Time - 表示穿越障碍时会增加的行驶时间。此字段仅适用于增加成本型障碍且仅在“中断单位”值基于时间时适用。此字段值必须大于或等于零，并且其单位与“中断单位”参数中指定的单位相同。 Additional_Distance - 表示穿越障碍时会增加的距离。此字段仅适用于增加成本型障碍且仅在“中断单位”值基于距离时适用。字段值必须大于或等于零，并且其单位与“中断单位”参数中指定的单位相同。 | Feature Set |
Line_Barriers (可选) | 指定一条或多条线，这些线相交的街道上禁止通行。例如，线障碍可用于对阻塞若干个路段交通的游行或抗议队伍进行建模。线障碍还可用于快速隔离多条道路使其禁止被穿越，从而在可能的路径中去除不符合要求的街道网络部分。 该工具限制了您可以使用“线障碍”参数限制的街道数量。可指定为线障碍的线数没有限制时，所有线的相交街道的合并数不能超过 500。 指定线障碍时，可使用以下特性为每个障碍设置名称属性： Name：障碍名称。 | Feature Set |
Polygon_Barriers | 指定面，该面完全限制通行或按比例调整行驶在面相交的街道上所需的行驶时间或距离。 该服务限制了您可以使用“面障碍”参数限制的街道数量。可指定为面障碍的面数没有限制时，所有面的相交街道的合并数不能超过 2,000。 指定面障碍时，可通过使用特性为每个面障碍设置属性，例如名称或障碍类型。可通过以下属性指定面障碍： Name：障碍名称。 BarrierType：指定障碍的存在会完全禁止通行还是按比例调整行程时间或距离。该字段值可指定为以下整数之一（请使用数值代码而非括号中的名称）：
ScaledTimeFactor - 它是与障碍相交街道的行驶时间要乘以的因子。此字段仅适用于调整成本型障碍且仅在“中断单位”值基于时间时适用。字段值必须大于零，并且其单位与“中断单位”参数中指定的单位相同。 ScaledDistanceFactor - 它是与障碍相交街道的距离要乘以的因子。此属性仅适用于调整成本型障碍且仅在“中断单位”值基于距离时适用。该属性值必须大于零。 | Feature Set |
Restrictions | 确定服务区时指定工具应该应用哪些行驶限制。 限制表示行驶偏好或要求。大多数情况下，限制条件会导致道路禁行。例如，使用“避开收费公路”限制的结果是，仅在访问某一事件点或设施点必须借道收费公路时，才会生成一条包含该收费公路的路径。高度限制则使您可以绕开低于车辆高度的间隙。如果车辆上装载着腐蚀性物质，使用“禁止任何危险物品”限制可以防止在标记着运输腐蚀性材料为非法行为的路上运输这些材料。 生成详细面时，禁止的道路不在服务区面的覆盖范围内，并可能导致面具有无法穿越的孔洞；而生成一般或等级服务区时，由可穿越的道路完全包围的受限道路将在简化服务区面的覆盖范围内。 以下是可用限制的列表和简短描述。 该工具支持以下限制：
| String |
Attribute_Parameter_Values (可选) | 指定某些限制需要的其他值，例如“重量限制”要求的车辆重量。您也可以使用属性参数指定限制对使用限制的行程是禁止、避免还是首选。如果该限制要避免或首选道路，您可以使用此参数进一步指定要避免或首选的程度。例如，您可以选择从不使用收费公路，尽可能地避开它们，或甚至格外倾向于使用它们。 如果指定了要素类的“属性参数值”参数，则要素类上的字段名称必须如下所示与字段相匹配： AttributeName：列出限制名称。 ParameterName：列出与限制相关的参数名称。限制根据其用途可有一个或多个 ParameterName 字段值。 ParameterValue：工具在评估限制时使用的 ParameterName 的值。 “属性参数值”取决于“限制”参数。仅当限制名称指定为“限制”参数值时，ParameterValue 字段才可用。 在“属性参数值”中，每个限制（以 AttributeName 形式列出）具有一个 ParameterName 字段值，指定限制的行程是禁止、避免还是首选的“限制用法”与道路选择避免或首选的限制和程度相关联。可为限制用法 ParameterName 分配下列字符串值，或在括号内列出等效数值：
大多数情况下，如果限制取决于车辆特征（如车辆高度），则可以使用“限制用法”的默认值 PROHIBITED。但是在某些情况下，“限制用法”的值取决于您的路径偏好。例如，“避开收费公路”限制具有“限制用法”参数的默认值 AVOID_MEDIUM。这表示在使用限制时，在可能的情况下工具会试图绕开收费公路。AVOID_MEDIUM 也表示查找最佳路径时避开收费公路的重要性，即优先级为中等。选择 AVOID_LOW 会降低避开收费公路的重要性；而选择 AVOID_HIGH 则会增加其重要性，因此服务为避开收费公路而生成更长的路径时更容易为人所接受。选择 PROHIBITED 则会完全不允许在收费公路上行驶，因此路径不可能经过收费公路的所有部分。但是请注意，避开或禁止收费公路并由此避开公路通行费只是一部分人的目的；对另外一部分人来说，因为避开拥堵的交通比交一些公路通行费更为重要，会宁愿走收费公路。在后一种情况中，您可以选择 PREFER_LOW、PREFER_MEDIUM 或 PREFER_HIGH 作为“限制用法”的值。首选的等级越高，工具为了在与限制相关的道路上行驶就会绕行更远的路程。 | Record Set |
Time_Zone_for_Time_of_Day (可选) | 指定时区或时间参数的时区。
无论时间的时区如何设置，当时间为非空值并且多个设施点的面设置为创建合并或非重叠面时，所有设施点必须处于同一时区。 | String |
Travel_Mode (可选) | 指定用于在分析中建模的交通模式。出行模式在 ArcGIS Online 中进行管理，组织管理员可通过对其进行配置更好地反映组织工作流。您需要指定组织所支持的出行模式名称。 要获取受支持出行模式名称的列表，请使用与访问此工具时使用的相同 GIS 服务器连接，并在实用程序工具箱中运行 GetTravelModes。GetTravelModes 会将表和支持的出行模式添加到应用程序中。可将“支持的出行模式”表中“出行模式名称”字段的任何值指定为输入。您还可以将“出行模式设置”字段中的值指定为输入。由于工具不必查找基于出行模式名称的设置，因而加快了工具执行。 默认值，自定义，可以使用自定义出行模式参数（在交汇点处 U 形转弯、应用等级、限制、属性参数值和阻抗）配置您自己的出行模式。自定义出行模式参数的默认值对使用汽车的出行方式建模。您可能希望选择自定义并设置上述自定义出行模式参数，从而以快速步行速度对行人建模，或以给定高度、重量和特定危险材料货物对卡车建模。您可以选择执行此操作来尝试不同的设置以获取想得到的分析结果。一旦确定了分析设置，您应该使用组织管理员身份并将这些设置保存为新建或现有出行模式的一部分，以便您组织中的所有人均返回相同设置的分析。 | String |
Impedance (可选) | 指定阻抗，其值表示沿交通网络的路段或其他部分行进所需的精力或成本。 行程距离是一种阻抗，可将以千米表示的道路长度作为阻抗。从这个意义上，行程距离对所有模式均相同，即对行人而言 1 千米的距离对汽车而言也是 1 千米。（但不同模式所允许行进的线路可能会有变化，而这会影响两点间的距离，可通过出行模式设置对此进行建模。） 行程时间也可以是一种阻抗，比如，汽车花费一分钟沿空无一人的道路行驶一公里。行程时间会随出行模式的不同而不同（行人可能需要 20 多分钟才能走完一公里），所以在建模时为出行模式选择正确的阻抗非常重要。 从以下阻抗值中选择：
除非将出行模式设置为自定义（这是默认值），否则会忽略您为此参数提供的值。 如果选择行驶时间、货运时间或步行时间，则必须将测量单位参数设置为基于时间的值，如果为阻抗选择了行程距离，则测量单位必须为基于距离的值。 | String |
Service_Areas (可选) | 请忽略此参数 - 它仅供内部使用。 | Feature Class |
Save_Output_Network_Analysis_Layer (可选) | 指定工具是否应将分析设置保存为网络分析图层文件。即使在 ArcGIS Desktop 应用程序（例如 ArcMap）中打开文件，仍然无法直接使用此文件。需要将其发送至 Esri 技术支持以诊断工具所返回结果的质量。
| Boolean |
Overrides (可选) | 求解网络分析问题时，指定可影响求解程序行为的其他设置。 需要在 JavaScript 对象表示法 (JSON) 中指定此参数的值。例如，有效值的格式如下：{"overrideSetting1" : "value1", "overrideSetting2" : "value2"}。覆盖设置名称始终以双引号括起。该值可以是数字、布尔值或字符串。 此参数的默认值为无值，表示不覆盖任何求解程序设置。 覆盖是高级设置，应仅在谨慎分析应用设置前后得到的结果之后使用。要获得每个求解程序支持的覆盖设置及其可接受值的列表，请联系 Esri 技术支持。 | string |
代码示例
GenerateServiceAreas 示例
以下 Python 脚本演示了如何在脚本中使用 GenerateServiceAreas 工具。
import arcpy
import time
import sys
username = "<your user name>"
password = "<your password>"
sa_service = "http://logistics.arcgis.com/arcgis/services;World/ServiceAreas;{0};{1}".format(username, password)
#Add the geoprocessing service as a toolbox. Use an alias when importing
arcpy.ImportToolbox(sa_service, "agol")
#Set the variables to call the tool
facilities = r"C:/data/Inputs.gdb/Stores"
output_service_areas = "C:/data/Results.gdb/StoreServiceAreas"
#Call the tool
result = arcpy.agol.GenerateServiceAreas(facilities, "5 10 15", "Minutes")
#Check the status of the result object every 0.5 seconds
#until it has a value of 4(succeeded) or greater
while result.status < 4:
time.sleep(0.5)
#print any warning or error messages returned from the tool
result_severity = result.maxSeverity
if result_severity == 2:
print "An error occured when running the tool"
print result.getMessages(2)
sys.exit(2)
elif result_severity == 1:
print "Warnings were returned when running the tool"
print result.getMessages(1)
#Get the output routes and save to a local geodatabase
result.getOutput(0).save(output_service_areas)
环境
此工具不使用任何地理处理环境。