Zusammenfassung
Erstellt einen Netzwerkanalyse-Layer für die nächstgelegene Einrichtung und legt seine Analyse-Eigenschaften fest. Ein Netzwerkanalyse-Layer für die nächstgelegene Einrichtung ist hilfreich, um die nächste Einrichtung oder die Einrichtungen zu einem Ereignis auf der Grundlage der angegebenen Netzwerkkosten zu bestimmen.
Verwendung
-
Nachdem Sie den Analyse-Layer mit diesem Werkzeug erstellt haben, können Sie ihm Netzwerkanalyse-Objekte mithilfe des Werkzeugs Standorte hinzufügen hinzufügen, die Analyse mit dem Werkzeug Berechnen berechnen und die Ergebnisse mit dem Werkzeug In Layer-Datei speichern auf der Festplatte speichern.
Bei Verwendung dieses Werkzeugs in Geoverarbeitungsmodellen muss der Ausgabe-Netzwerkanalyse-Layer in einen Modellparameter geändert werden, wenn das Modell als Werkzeug ausgeführt wird. Andernfalls wird der Ausgabe-Layer dem Inhalt der Karte nicht hinzugefügt.
Syntax
arcpy.na.MakeClosestFacilityLayer(in_network_dataset, out_network_analysis_layer, impedance_attribute, {travel_from_to}, {default_cutoff}, {default_number_facilities_to_find}, {accumulate_attribute_name}, {UTurn_policy}, {restriction_attribute_name}, {hierarchy}, {hierarchy_settings}, {output_path_shape}, {time_of_day}, {time_of_day_usage})| Parameter | Erklärung | Datentyp |
in_network_dataset | Das Netzwerk-Dataset, für das die Analyse der nächstgelegenen Einrichtung ausgeführt wird. | Network Dataset Layer |
out_network_analysis_layer | Name des zu erstellenden Netzwerkanalyse-Layers für die nächstgelegene Einrichtung. | String |
impedance_attribute | Das Kostenattribut, das in der Analyse als Widerstand verwendet wird. | String |
travel_from_to (optional) | Gibt die Fahrtrichtung zwischen Einrichtungen und Ereignissen an.
Mithilfe dieser Option können in einem Netzwerk mit Beschränkungen für Einbahnstraßen und unterschiedlichen Impedanzen basierend auf der Fahrtrichtung verschiedene Einrichtungen gesucht werden. So kann eine Einrichtung zum Beispiel 10 Minuten Fahrzeit vom Ereignis entfernt sein, wenn die Fahrt vom Ereignis zur Einrichtung erfolgt, jedoch 15 Minuten Fahrzeit entfernt, wenn die Fahrt von der Einrichtung zum Ereignis erfolgt. | String |
default_cutoff (optional) | Standardimpedanzwert, an dem die Suche nach Einrichtungen für ein gegebenes Ereignis beendet wird. Der Standardwert kann durch Angabe des Grenzwertes für Ereignisse überschrieben werden, wenn die Fahrtrichtung von den Ereignissen zu den Einrichtungen erfolgt, oder durch Angabe des Grenzwertes für Einrichtungen, wenn die Fahrtrichtung von den Einrichtungen zu den Ereignissen erfolgt. | Double |
default_number_facilities_to_find (optional) | Standardanzahl der nächsten Einrichtungen, die pro Ereignis gesucht werden sollen. Der Standard kann überschrieben werden, indem ein Wert für die Eigenschaft "TargetFacilityCount" der Ereignisse angegeben wird. | Long |
accumulate_attribute_name [accumulate_attribute_name,...] (optional) | Eine Liste mit Kostenattributen, die während der Analyse akkumuliert werden sollen. Diese Akkumulationsattribute dienen ausschließlich zu Referenzzwecken. Der Solver verwendet nur das vom Parameter Impedanzattribut angegebene Kostenattribut zum Berechnen der Route. Für jedes akkumulierte Kostenattribut wird den vom Solver ausgegebenen Routen eine Total_[Impedance]-Eigenschaft hinzugefügt. | String |
UTurn_policy (optional) | Die Wendenregel an Knoten. Das Zulassen von Wenden bedeutet, dass der Solver an einem Knoten wenden und auf der gleichen Straße wieder zurückführen kann. Da diese Knoten Straßenkreuzungen und Sackgassen darstellen können, kann es sein, dass verschiedene Fahrzeuge an manchen Knoten wenden können und an anderen wiederum nicht. Dies hängt davon ab, ob der Knoten eine Kreuzung oder eine Sackgasse darstellt. Um dies zu berücksichtigen, wird der Parameter "Wendenregel" implizit durch die Anzahl der mit der Kreuzung verbundenen Kanten angegeben. Diese Anzahl wird als Valenz der Knoten bezeichnet. Die zulässigen Werte für diesen Parameter sowie eine Beschreibung der jeweiligen Bedeutung in Bezug auf die Valenz der Knoten sind unten aufgelistet.
Falls Sie eine Wendenregel benötigen, die genauer definiert ist, können Sie einem Netzwerkkostenattribut einen globalen Evaluator für Verzögerung bei Kantenübergängen hinzufügen oder dessen Einstellungen anpassen, sofern dieser vorhanden ist, und der Konfiguration von U-förmigen Kantenübergängen einen besonderen Stellenwert einräumen. Ziehen Sie auch die Einstellung der CurbApproach-Eigenschaft Ihrer Netzwerkstandorte in Erwägung. | String |
restriction_attribute_name [restriction_attribute_name,...] (optional) | Eine Liste mit Beschränkungsattributen, die während der Analyse angewendet werden sollen. | String |
hierarchy (optional) |
Der Parameter wird nicht verwendet, wenn ein Hierarchie-Attribut nicht für das Netzwerk-Dataset definiert ist, das zum Durchführen der Analyse verwendet wird. Verwenden Sie in solchen Fällen "#" als Parameterwert. | Boolean |
hierarchy_settings (optional) | Network Analyst Hierarchy Settings | |
output_path_shape (optional) | Gibt den Shape-Typ für die Routen-Features an, die von der Analyse ausgegeben werden.
Gleichgültig, welcher Ausgabe-Shape-Typ gewählt wird, die optimale Route wird immer durch die Netzwerkimpedanz und nie durch die Euklidische Entfernung bestimmt. Dies bedeutet, dass sich nur die Routen-Shapes und nicht der zugrunde liegende Durchlauf des Netzwerks unterscheiden. | String |
time_of_day (optional) | Gibt die Uhrzeit und das Datum für den Beginn oder das Ende der Routen an. Die Interpretation dieses Wertes hängt davon ab, ob "Verwendung der Uhrzeit" auf START_TIME oder END_TIME festgelegt ist. Wenn Sie ein verkehrsbasiertes Impedanzattribut ausgewählt haben, wird die Lösung auf Grundlage des dynamischen Verkehrsaufkommens zu der hier angegebenen Uhrzeit generiert. Sie können ein Datum und eine Uhrzeit im Format 14.5.2012 10:30 angeben. Statt ein bestimmtes Datum zu verwenden, kann ein Wochentag mithilfe der folgenden Datumsangaben angegeben werden:
| Date |
time_of_day_usage (optional) | Gibt an, ob der Wert des Parameters "Zeitpunkt" die Ankunfts- oder Abfahrtzeit für die Route oder die Routen darstellt.
| String |
Abgeleitete Ausgabe
| Name | Erklärung | Datentyp |
| output_layer | Der neu erstellte Netzwerkanalyse-Layer. | Network Analyst-Layer |
Codebeispiel
MakeClosestFacilityLayer – Beispiel 1 (Python-Fenster)
Ausführen des Werkzeugs, wenn nur die erforderlichen Parameter verwendet werden.
network = "C:/Data/SanFrancisco.gdb/Transportation/Streets_ND"
arcpy.na.MakeClosestFacilityLayer(network, "ClosestFireStations", "TravelTime")
MakeClosestFacilityLayer – Beispiel 2 (Python-Fenster)
Führen Sie das Werkzeug unter Verwendung aller Parameter aus.
network = "C:/Data/SanFrancisco.gdb/Transportation/Streets_ND"
arcpy.na.MakeClosestFacilityLayer(network, "ClosestHospitals", "TravelTime",
"TRAVEL_TO", 5 ,3, ["Meters", "TravelTime"],
"ALLOW_UTURNS", ["Oneway"], "USE_HIERARCHY",
"", "TRUE_LINES_WITH_MEASURES")
MakeClosestFacilityLayer – Beispiel 3 (Workflow)
Mit dem folgenden eigenständigen Python-Skript wird veranschaulicht, wie das Werkzeug MakeClosestFacilityLayer verwendet werden kann, um von den Ladenstandorten aus das nächst gelegene Lager zu ermitteln.
# Name: MakeClosestFacilityLayer_Workflow.py
# Description: Find the closest warehouse from the store locations and save the
# results to a layer file on disk.
# Requirements: Network Analyst Extension
#Import system modules
import arcpy
from arcpy import env
import os
try:
#Check out the Network Analyst extension license
arcpy.CheckOutExtension("Network")
#Set environment settings
env.workspace = r"C:/data/Paris.gdb"
env.overwriteOutput = True
#Set local variables
inNetworkDataset = r"Transportation/ParisMultimodal_ND"
outNALayerName = "ClosestWarehouse"
impedanceAttribute = "Drivetime"
accumulateAttributeName = ["Meters"]
inFacilities = r"Analysis/Warehouses"
inIncidents = r"Analysis/Stores"
outLayerFile = os.path.join(r"C:/data/output", outNALayerName + ".lyr")
#Create a new closest facility analysis layer. Apart from finding the drive
#time to the closest warehouse, we also want to find the total distance. So
#we will accumulate the "Meters" impedance attribute.
NAResultObject = arcpy.na.MakeClosestFacilityLayer(inNetworkDataset,outNALayerName,
impedanceAttribute,"TRAVEL_TO",
"",1, accumulateAttributeName,
"NO_UTURNS")
#Get the layer object from the result object. The closest facility layer can
#now be referenced using the layer object.
outNALayer = NAResultObject.getOutput(0)
#Get the names of all the sublayers within the closest facility layer.
subLayerNames = arcpy.na.GetNAClassNames(outNALayer)
#Stores the layer names that we will use later
facilitiesLayerName = subLayerNames["Facilities"]
incidentsLayerName = subLayerNames["Incidents"]
#Load the warehouses as Facilities using the default field mappings and
#search tolerance
arcpy.na.AddLocations(outNALayer, facilitiesLayerName, inFacilities, "", "")
#Load the Stores as Incidents. Map the Name property from the NOM field
#using field mappings
fieldMappings = arcpy.na.NAClassFieldMappings(outNALayer, incidentsLayerName)
fieldMappings["Name"].mappedFieldName = "NOM"
arcpy.na.AddLocations(outNALayer, incidentsLayerName, inIncidents,
fieldMappings,"")
#Solve the closest facility layer
arcpy.na.Solve(outNALayer)
#Save the solved closest facility layer as a layer file on disk with
#relative paths
arcpy.management.SaveToLayerFile(outNALayer,outLayerFile,"RELATIVE")
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)
Umgebungen
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja