Ajouter des localisations (Network Analyst)

Synthèse

Ajoute des enregistrements ou entités en entrée à une couche d’analyse de réseau. Les entrées sont ajoutées à des sous-couches spécifiques telles que Arrêts et Interruptions. Lorsque la couche d’analyse de réseau fait référence à un jeu de données réseau comme source de données réseau, l’outil calcule les localisations de réseau des entrées, sauf si les champs de localisation de réseau précalculés sont appariés à partir des entrées.

En savoir plus sur la manière dont l’outil Add Locations (Ajouter des emplacements) localise des entrées d’analyse sur le réseau

Utilisation

  • Lors de la localisation des entrées, le mode de déplacement de la couche d’analyse de réseau et les interruptions existantes sont pris en compte. Il est par conséquent recommandé de définir le mode de déplacement pour l’analyse et de charger les interruptions avant de charger les autres entrées de l’analyse.

  • Les valeurs des paramètres Search Tolerance (Tolérance de recherche), Search Criteria (Critères de recherche) et Search Query (Requête de recherche) sont automatiquement renseignées en fonction des propriétés de localisation enregistrées dans la couche d’analyse de réseau en entrée. Si la couche d’analyse de réseau a des remplacements de paramètres de localisation pour la sous-couche sélectionnée, ces paramètres sont utilisés. Sinon, les paramètres de localisation par défaut de la couche d’analyse de réseau sont utilisés.

    En savoir plus sur les paramètres de localisation d’une couche d’analyse de réseau

  • Si vous modifiez la valeur du paramètre Search Tolerance (Tolérance de recherche), Search Criteria (Critères de recherche) ou Search Query (Requête de recherche), l’exécution de l’outil mettra à jour les remplacements de paramètres de localisation de la couche d’analyse de réseau pour la sous-couche sélectionnée. L’enregistrement de ces paramètres de localisation dans la couche d’analyse de réseau permet de s’assurer que les déplacements automatiques effectués au moment du calcul respectent les paramètres de localisation que vous avez utilisés lors du calcul initial des localisations de réseau.

  • Si la couche d’analyse fait référence à un service de portail, les champs de localisation ne sont pas calculés avant l’analyse. Pour ces couches, l’outil Add Locations (Ajouter des localisations) ajoute les entrées à la couche d’analyse sans calculer les champs de localisation. Par conséquent, certains paramètres de l’outil ne s’appliquent pas à ces couches et sont masqués dans la fenêtre Geoprocessing (Géotraitement) et ignorés dans Python.

Paramètres

ÉtiquetteExplicationType de données
Couche d’analyse de réseau en entrée

La couche d'analyse de réseau à laquelle les objets d'analyse de réseau seront ajoutés.

Network Analyst Layer
Sous-couche

Nom de la sous-couche de la couche d’analyse de réseau à laquelle les objets d’analyse de réseau seront ajoutés.

String
Emplacements en entrée

Classes d’entités ou table contenant les localisations à ajouter à la sous-couche d’analyse de réseau.

Table View
Appariements de champs
(Facultatif)

L’appariement entre les champs en entrée de la sous-couche d’analyse de réseau à laquelle les localisations seront ajoutées et les champs dans les données en entrée ou les constantes spécifiées.

Les sous-couches en entrée des couches d’analyse de réseau comportent un ensemble de champs en entrée qui peuvent être renseignés pour modifier ou contrôler le comportement d’analyse. Lorsque vous ajoutez des localisations à la sous-couche, vous pouvez utiliser ce paramètre pour apparier les valeurs de champ de la table en entrée à ces champs dans la sous-couche. Vous pouvez également utiliser des appariements de champs afin de spécifier une valeur par défaut constante pour chaque propriété.

Si les valeurs Field (Champ) et Default (Par défaut) ne sont pas spécifiées pour une propriété, les objets d’analyse de réseau obtenus ont des valeurs nulles pour cette propriété.

Une liste complète de champs en entrée pour chaque sous-couche pour chaque type de couche d’analyse de réseau est disponible dans la documentation de chaque couche. Par exemple, examinez les champs en entrée de la sous-couche Arrêts de la couche Route.

Si les données en cours de chargement contiennent des localisations de réseau ou des plages de localisation basées sur la source de données réseau et le mode de déplacement utilisé pour l’analyse, sélectionnez l’option Use Network Location Fields (Utiliser les champs de localisation du réseau) dans le menu déroulant. L’ajout des objets d’analyse de réseau à l’aide des champs de localisation de réseau est plus rapide que le chargement par géométrie.

Pour en savoir plus sur les champs de localisation réseau

Remarque :

ArcGIS Online et certains portails ArcGIS Enterprise ne prennent pas en charge l’utilisation des champs de localisation de réseau. Pour les couches d’analyse de réseau qui utilisent un de ces portails comme source de données réseau, toutes les entrées sont localisées au moment du calcul, et tous les champs de localisation appariés sont ignorés.

Network Analyst Class FieldMap
Tolérance de recherche
(Facultatif)

Distance de recherche maximum qui est utilisée pour la localisation des entités en entrée appartenant au réseau. Les entités qui se trouvent hors de la tolérance de recherche ne seront pas localisées. Le paramètre comprend une valeur et des unités.

La valeur par défaut de ce paramètre est déterminée en fonction des propriétés de localisation stockées dans la couche d’analyse de réseau en entrée. Si la couche d’analyse de réseau a des remplacements de paramètres de localisation pour la sous-couche sélectionnée, ces paramètres seront utilisés. Sinon, les paramètres de localisation par défaut de la couche d’analyse de réseau seront utilisés. La définition d’une valeur différente de la valeur par défaut pour ce paramètre met à jour les remplacements de paramètres de localisation de la couche d’analyse de réseau pour la sous-couche sélectionnée.

Le paramètre n’est pas utilisé lors de l’ajout d’emplacements aux sous-couches avec une géométrie de type ligne ou polygone, comme les interruptions linéaires et les interruptions polygonales.

Ce paramètre n’est pas utilisé lorsque vous ajoutez des localisations qui utilisent des champs de localisation de réseau existants.

Héritage :

Ce paramètre n’est pas utilisé lorsque la source de données de réseau de la couche d’analyse de réseau est un portail exécutant une version de ArcGIS Enterprise antérieure à la version 11.0.

Linear Unit
Champ de tri
(Facultatif)

Le champ dans lequel les objets d’analyse de réseau sont triés lorsqu’ils sont ajoutés à la couche d’analyse de réseau. La valeur par défaut est le champ ObjectID de la classe d’entités ou la table en entrée.

Field
Critères de recherche
(Facultatif)

Sources de tronçon et de jonction du jeu de données réseau qui sont parcourues lors de la localisation des entrées sur le réseau. Par exemple, si le jeu de données réseau référence des classes d’entités distinctes représentant des rues et des trottoirs, vous pouvez localiser les entrées sur les rues mais pas sur les trottoirs.

Les choix de type de capture disponibles pour chaque source de réseau sont les suivants :

  • None (Aucune) : le point ne se trouve sur aucun élément dans cette source de réseau.
  • Shape (Forme) : le point se trouve sur le point le plus proche d’un élément dans cette source de réseau.
  • Middle (Milieu) : cette option est obsolète et se comporte de la même manière que l’option Shape (Forme).
  • End (Fin) : cette option est obsolète et se comporte de la même manière que l’option Shape (Forme).

La valeur par défaut de ce paramètre est déterminée en fonction des propriétés de localisation stockées dans la couche d’analyse de réseau en entrée. Si la couche d’analyse de réseau a des remplacements de paramètres de localisation pour la sous-couche sélectionnée, ces paramètres seront utilisés. Sinon, les paramètres de localisation par défaut de la couche d’analyse de réseau seront utilisés. La définition d’une valeur différente de la valeur par défaut pour ce paramètre met à jour les remplacements de paramètres de localisation de la couche d’analyse de réseau pour la sous-couche sélectionnée.

Ce paramètre n’est pas utilisé lorsque vous ajoutez des localisations qui utilisent des champs de localisation de réseau existants.

Ce paramètre n’est pas utilisé lorsque la source de données de réseau de la couche d’analyse de réseau est ArcGIS Online.

Héritage :

Ce paramètre n’est pas utilisé lorsque la source de données de réseau de la couche d’analyse de réseau est un portail exécutant une version de ArcGIS Enterprise antérieure à la version 11.0.

Value Table
Rechercher la classe la plus proche
(Facultatif)

Héritage :
Ce paramètre est obsolète et conservé uniquement en vue de la rétrocompatibilité. Les entrées sont toujours appariées à la source de réseau la plus proche parmi les sources utilisées pour la localisation, correspondant à une valeur de paramètre de MATCH_TO_CLOSEST ou True.

Boolean
Ajouter aux emplacements existants
(Facultatif)

Spécifie si les nouveaux objets d’analyse de réseau seront ajoutés aux objets existants.

  • Activé : les nouveaux objets d’analyse de réseau sont ajoutés au jeu d’objets existant dans la sous-couche sélectionnée. Il s’agit de l’option par défaut.
  • Désactivé : les objets d’analyse de réseau existants sont supprimés et remplacés par les nouveaux objets.
Boolean
Capturer sur le réseau
(Facultatif)

Indique si les entrées seront capturées sur leurs localisations de réseau calculées ou représentées à leur localisation géographique d’origine.

Pour utiliser l’approche du trottoir dans l’analyse afin de contrôler le côté de la route qu’un véhicule doit utiliser pour s’approcher d’une localisation, ne capturez pas les entrées sur leurs localisations de réseau, ou utilisez un décalage de capture pour garantir que le point reste clairement d’un côté de la route.

Le paramètre n’est pas utilisé lors de l’ajout d’emplacements aux sous-couches avec une géométrie de type ligne ou polygone, comme les interruptions linéaires et les interruptions polygonales.

Ce paramètre n’est pas utilisé lorsque la source de données de réseau de la couche d’analyse de réseau en entrée est un service de portail.

  • Activé : les géométries des localisations de réseau sont capturées sur les localisations de réseau correspondantes.
  • Désactivé : les géométries des localisations de réseau dépendent des géométries des entités en entrée. Il s’agit de l’option par défaut.
Boolean
Décalage de capture
(Facultatif)

Distance de décalage qui sera appliquée lors de la capture d’un point sur le réseau. Une valeur de décalage de zéro indique que le point sera coïncident avec l'entité de réseau (généralement une ligne). Pour décaler le point à partir de l'entité de réseau, entrez une valeur de décalage. Le décalage est relatif à l'emplacement du point d'origine ; autrement dit, si le point d'origine se trouvait du côté gauche, son nouvel emplacement sera décalé vers la gauche. De même, s'il se trouvait du côté droit, il sera décalé vers la droite.

La valeur par défaut est définie sur 5 mètres. Ce paramètre est toutefois ignoré sauf si le paramètre Snap to Network (Capturer sur le réseau) est désactivé.

Le paramètre n’est pas utilisé lors de l’ajout d’emplacements aux sous-couches avec une géométrie de type ligne ou polygone, comme les interruptions linéaires et les interruptions polygonales.

Ce paramètre n’est pas utilisé lorsque la source de données de réseau de la couche d’analyse de réseau en entrée est un service de portail.

Linear Unit
Exclure les portions restreintes du réseau
(Facultatif)

Héritage :
Ce paramètre est obsolète et conservé uniquement en vue de la rétrocompatibilité. Les entrées d’analyse ne sont jamais localisées sur des éléments de réseau restreints, correspondant à une valeur de paramètre de EXCLUDE ou True.

Boolean
Requête de recherche
(Facultatif)

Requête visant à restreindre la recherche à un sous-ensemble d’entités dans une classe d’entités source. Ceci s'avère utile si vous ne voulez pas trouver d'entités ne convenant pas à une localisation de réseau. Par exemple, si vous ne souhaitez pas localiser sur les bretelles d’autoroute, vous pouvez définir une requête qui les exclut. Une expression SQL distincte peut être spécifiée par classe d’entités source de tronçons ou de jonctions du jeu de données réseau.

Aucune requête ne sera appliquée à une source de réseau non spécifiée explicitement dans la fenêtre Geoprocessing (Géotraitement).

La valeur par défaut de ce paramètre est déterminée en fonction des propriétés de localisation stockées dans la couche d’analyse de réseau en entrée. Si la couche d’analyse de réseau a des remplacements de paramètres de localisation pour la sous-couche sélectionnée, ces paramètres seront utilisés. Sinon, les paramètres de localisation par défaut de la couche d’analyse de réseau seront utilisés. La définition d’une valeur différente de la valeur par défaut pour ce paramètre met à jour les remplacements de paramètres de localisation de la couche d’analyse de réseau pour la sous-couche sélectionnée.

Ce paramètre n’est pas utilisé lorsque vous ajoutez des localisations qui utilisent des champs de localisation de réseau existants.

Ce paramètre n’est pas utilisé lorsque la source de données de réseau de la couche d’analyse de réseau est ArcGIS Online.

Héritage :

Ce paramètre n’est pas utilisé lorsque la source de données de réseau de la couche d’analyse de réseau est un portail exécutant une version de ArcGIS Enterprise antérieure à la version 11.0.

Value Table
Autoriser la relocalisation automatique au moment du calcul
(Facultatif)

Indique si les entrées avec des champs de localisation de réseau existant peuvent être automatiquement déplacées lors du calcul afin de garantir que les champs de localisation sont valides et accessibles pour l’analyse.

  • Activé : les points situés sur des éléments de réseau restreints et les points concernés par des interruptions seront déplacés vers la localisation accessible la plus proche au moment du calcul. Il s’agit de l’option par défaut.
  • Désactivé : les champs de localisation de réseau seront utilisés tels quels au moment du calcul, même si les points sont inaccessibles. Cela peut provoquer un échec du calcul.

La valeur par défaut de ce paramètre est déterminée en fonction des propriétés de localisation stockées dans la couche d’analyse de réseau en entrée. Si la couche d’analyse de réseau a des remplacements de paramètres de localisation pour la sous-couche sélectionnée, ces paramètres seront utilisés. Sinon, les paramètres de localisation par défaut de la couche d’analyse de réseau seront utilisés. La définition d’une valeur différente de la valeur par défaut pour ce paramètre met à jour les remplacements de paramètres de localisation de la couche d’analyse de réseau pour la sous-couche sélectionnée.

Même si la relocalisation automatique au moment du calcul n’est pas autorisée, les entrées sans champs de localisation ou avec des champs de localisation incomplets seront localisées au moment du calcul.

Ce paramètre n’est pas utilisé lorsque la source de données de réseau de la couche d’analyse de réseau est ArcGIS Online.

Ce paramètre n’est pas utilisé lorsque la source de données de réseau de la couche d’analyse de réseau est un portail ArcGIS Enterprise qui ne prend pas en charge l’utilisation des champs de localisation de réseau.

Héritage :

Ce paramètre n’est pas utilisé lorsque la source de données de réseau de la couche d’analyse de réseau est un portail exécutant une version de ArcGIS Enterprise antérieure à la version 11.0.

Boolean

Sortie obtenue

ÉtiquetteExplicationType de données
Couche d'analyse de réseau en entrée mise à jour

La couche d’analyse de réseau mise à jour.

Network Analyst Layer

arcpy.management.AddLocations(in_network_analysis_layer, sub_layer, in_table, {field_mappings}, {search_tolerance}, {sort_field}, {search_criteria}, {match_type}, {append}, {snap_to_position_along_network}, {snap_offset}, {exclude_restricted_elements}, {search_query}, {allow_auto_relocate})
NomExplicationType de données
in_network_analysis_layer

La couche d'analyse de réseau à laquelle les objets d'analyse de réseau seront ajoutés.

Network Analyst Layer
sub_layer

Nom de la sous-couche de la couche d’analyse de réseau à laquelle les objets d’analyse de réseau seront ajoutés.

String
in_table

Classes d’entités ou table contenant les localisations à ajouter à la sous-couche d’analyse de réseau.

Table View
field_mappings
(Facultatif)

L’appariement entre les champs en entrée de la sous-couche d’analyse de réseau à laquelle les localisations seront ajoutées et les champs dans les données en entrée ou les constantes spécifiées.

Les sous-couches en entrée des couches d’analyse de réseau comportent un ensemble de champs en entrée qui peuvent être renseignés pour modifier ou contrôler le comportement d’analyse. Lorsque vous ajoutez des localisations à la sous-couche, vous pouvez utiliser ce paramètre pour apparier les valeurs de champ de la table en entrée à ces champs dans la sous-couche. Vous pouvez également utiliser des appariements de champs afin de spécifier une valeur par défaut constante pour chaque propriété.

Si les valeurs Field (Champ) et Default (Par défaut) ne sont pas spécifiées pour une propriété, les objets d’analyse de réseau obtenus ont des valeurs nulles pour cette propriété.

Une liste complète de champs en entrée pour chaque sous-couche pour chaque type de couche d’analyse de réseau est disponible dans la documentation de chaque couche. Par exemple, examinez les champs en entrée de la sous-couche Arrêts de la couche Route.

Un objet NAClassFieldMappings issu de la classe NAClassFieldMappings permet de spécifier la valeur de paramètre. L’objet NAClassFieldMappings est une collection d’objets NAClassFieldMap qui permet de spécifier les valeurs par défaut ou d’apparier un nom de champ issu des entités en entrée pour les propriétés de l’objet d’analyse de réseau. Si les données en cours de chargement contiennent des localisations de réseau ou des plages de localisation basées sur le jeu de données réseau utilisé pour l’analyse, appariez les champs de localisation du réseau des entités en entrée aux propriétés de localisation de réseau. La spécification des champs de localisation de réseau dans les appariements de champs est similaire à l’utilisation de l’option Use Network Location Fields (Utiliser les champs de localisation du réseau) dans la boîte de dialogue de l’outil.

Pour en savoir plus sur les champs de localisation réseau

Remarque :

ArcGIS Online et certains portails ArcGIS Enterprise ne prennent pas en charge l’utilisation des champs de localisation de réseau. Pour les couches d’analyse de réseau qui utilisent un de ces portails comme source de données réseau, toutes les entrées sont localisées au moment du calcul, et tous les champs de localisation appariés sont ignorés.

Network Analyst Class FieldMap
search_tolerance
(Facultatif)

Distance de recherche maximum qui est utilisée pour la localisation des entités en entrée appartenant au réseau. Les entités qui se trouvent hors de la tolérance de recherche ne seront pas localisées. Le paramètre comprend une valeur et des unités.

La valeur par défaut de ce paramètre est déterminée en fonction des propriétés de localisation stockées dans la couche d’analyse de réseau en entrée. Si la couche d’analyse de réseau a des remplacements de paramètres de localisation pour la sous-couche sélectionnée, ces paramètres seront utilisés. Sinon, les paramètres de localisation par défaut de la couche d’analyse de réseau seront utilisés. La définition d’une valeur différente de la valeur par défaut pour ce paramètre met à jour les remplacements de paramètres de localisation de la couche d’analyse de réseau pour la sous-couche sélectionnée.

Le paramètre n’est pas utilisé lors de l’ajout d’emplacements aux sous-couches avec une géométrie de type ligne ou polygone, comme les interruptions linéaires et les interruptions polygonales.

Ce paramètre n’est pas utilisé lorsque vous ajoutez des localisations qui utilisent des champs de localisation de réseau existants.

Héritage :

Ce paramètre n’est pas utilisé lorsque la source de données de réseau de la couche d’analyse de réseau est un portail exécutant une version de ArcGIS Enterprise antérieure à la version 11.0.

Linear Unit
sort_field
(Facultatif)

Le champ dans lequel les objets d’analyse de réseau sont triés lorsqu’ils sont ajoutés à la couche d’analyse de réseau. La valeur par défaut est le champ ObjectID de la classe d’entités ou la table en entrée.

Field
search_criteria
[[Source, SnapType],...]
(Facultatif)

Sources de tronçon et de jonction du jeu de données réseau qui sont parcourues lors de la localisation des entrées sur le réseau. Par exemple, si le jeu de données réseau référence des classes d’entités distinctes représentant des rues et des trottoirs, vous pouvez localiser les entrées sur les rues mais pas sur les trottoirs.

La valeur de paramètre est spécifiée sous forme de liste avec des listes imbriquées. Les listes imbriquées se composent de deux valeurs indiquant le nom et le type de capture de chaque source de données du réseau.

Les choix de type de capture disponibles pour chaque source de réseau sont les suivants :

  • NONE : le point ne se trouve sur aucun élément dans cette source de données du réseau.
  • SHAPE : le point se trouve sur le point le plus proche d’un élément dans cette source de données du réseau.

Par exemple, la valeur de paramètre [["Streets","SHAPE"],["Streets_ND_Junctions","NONE"]] spécifie que la recherche peut porter sur la forme de la source Streets, mais non sur la source Streets_ND_Junctions.

Les sources de tronçons ou de jonctions du réseau qui ne sont pas incluses dans cette liste utiliseront ce type de capture par défaut. Il est recommandé d’inclure toutes les sources de données du réseau dans votre liste et de définir explicitement le type de capture de chacune.

Héritage :
Historiquement, l’outil prenait en charge les options de type de capture MIDDLE, END et MIDDLE_END. Ces options sont obsolètes et sont conservées uniquement en vue de la rétrocompatibilité. Si l’une de ces options est spécifiée, l’outil revient à l’option SHAPE pour cette source de réseau.

La valeur par défaut de ce paramètre est déterminée en fonction des propriétés de localisation stockées dans la couche d’analyse de réseau en entrée. Si la couche d’analyse de réseau a des remplacements de paramètres de localisation pour la sous-couche sélectionnée, ces paramètres seront utilisés. Sinon, les paramètres de localisation par défaut de la couche d’analyse de réseau seront utilisés. La définition d’une valeur différente de la valeur par défaut pour ce paramètre met à jour les remplacements de paramètres de localisation de la couche d’analyse de réseau pour la sous-couche sélectionnée.

Ce paramètre n’est pas utilisé lorsque vous ajoutez des localisations qui utilisent des champs de localisation de réseau existants.

Ce paramètre n’est pas utilisé lorsque la source de données de réseau de la couche d’analyse de réseau est ArcGIS Online.

Héritage :

Ce paramètre n’est pas utilisé lorsque la source de données de réseau de la couche d’analyse de réseau est un portail exécutant une version de ArcGIS Enterprise antérieure à la version 11.0.

Value Table
match_type
(Facultatif)

Héritage :
Ce paramètre est obsolète et conservé uniquement en vue de la rétrocompatibilité. Les entrées sont toujours appariées à la source de réseau la plus proche parmi les sources utilisées pour la localisation, correspondant à une valeur de paramètre de MATCH_TO_CLOSEST ou True.

Boolean
append
(Facultatif)

Spécifie si les nouveaux objets d’analyse de réseau seront ajoutés aux objets existants.

  • APPENDLes nouveaux objets d’analyse de réseau sont ajoutés au jeu d’objets existant dans la sous-couche sélectionnée. Il s’agit de l’option par défaut.
  • CLEARLes objets d’analyse de réseau existants sont supprimés et remplacés par les nouveaux objets.
Boolean
snap_to_position_along_network
(Facultatif)

Indique si les entrées seront capturées sur leurs localisations de réseau calculées ou représentées à leur localisation géographique d’origine.

Pour utiliser l’approche du trottoir dans l’analyse afin de contrôler le côté de la route qu’un véhicule doit utiliser pour s’approcher d’une localisation, ne capturez pas les entrées sur leurs localisations de réseau, ou utilisez un décalage de capture pour garantir que le point reste clairement d’un côté de la route.

Le paramètre n’est pas utilisé lors de l’ajout d’emplacements aux sous-couches avec une géométrie de type ligne ou polygone, comme les interruptions linéaires et les interruptions polygonales.

Ce paramètre n’est pas utilisé lorsque la source de données de réseau de la couche d’analyse de réseau en entrée est un service de portail.

  • NO_SNAPLes géométries des localisations de réseau dépendent des géométries des entités en entrée. Il s’agit de l’option par défaut.
  • SNAPLes géométries des localisations de réseau sont capturées sur les localisations de réseau correspondantes.
Boolean
snap_offset
(Facultatif)

Distance de décalage qui sera appliquée lors de la capture d’un point sur le réseau. Une valeur de décalage de zéro indique que le point sera coïncident avec l'entité de réseau (généralement une ligne). Pour décaler le point à partir de l'entité de réseau, entrez une valeur de décalage. Le décalage est relatif à l'emplacement du point d'origine ; autrement dit, si le point d'origine se trouvait du côté gauche, son nouvel emplacement sera décalé vers la gauche. De même, s'il se trouvait du côté droit, il sera décalé vers la droite.

La valeur par défaut est définie sur 5 mètres. Ce paramètre est toutefois ignoré sauf si le paramètre snap_to_position_along_network est défini sur NO_SNAP.

Le paramètre n’est pas utilisé lors de l’ajout d’emplacements aux sous-couches avec une géométrie de type ligne ou polygone, comme les interruptions linéaires et les interruptions polygonales.

Ce paramètre n’est pas utilisé lorsque la source de données de réseau de la couche d’analyse de réseau en entrée est un service de portail.

Linear Unit
exclude_restricted_elements
(Facultatif)

Héritage :
Ce paramètre est obsolète et conservé uniquement en vue de la rétrocompatibilité. Les entrées d’analyse ne sont jamais localisées sur des éléments de réseau restreints, correspondant à une valeur de paramètre de EXCLUDE ou True.

Boolean
search_query
[[Source, Expression],...]
(Facultatif)

Requête visant à restreindre la recherche à un sous-ensemble d’entités dans une classe d’entités source. Ceci s'avère utile si vous ne voulez pas trouver d'entités ne convenant pas à une localisation de réseau. Par exemple, si vous ne souhaitez pas localiser sur les bretelles d’autoroute, vous pouvez définir une requête qui les exclut. Une expression SQL distincte peut être spécifiée par classe d’entités source de tronçons ou de jonctions du jeu de données réseau.

La valeur de paramètre est spécifiée sous forme de liste avec des listes imbriquées, avec une entrée par source de réseau. Chaque liste interne se compose de deux valeurs indiquant le nom de la source de réseau et l’expression SQL utilisée comme requête pour cette source. Une chaîne vide, "", indique qu’il n’existe aucune requête pour une source donnée.

Par exemple, la valeur [["Streets", "ROAD_CLASS <> 3"], ["Streets_ND_Junctions", ""]] spécifie une expression SQL pour la classe d’entités source Streets et aucune expression pour la classe d’entités source Streets_ND_Junctions. Si une source de réseau n’est pas incluse dans la liste, elle est interprétée comme n’ayant pas de requête. La valeur [["Streets", "ROAD_CLASS <> 3"]] est équivalente à [["Streets", "ROAD_CLASS <> 3"], ["Streets_ND_Junctions", ""]].

Pour plus d'informations sur la syntaxe SQL, reportez-vous à la rubrique Référence SQL pour les expressions de requête utilisées dans ArcGIS.

La valeur par défaut de ce paramètre est déterminée en fonction des propriétés de localisation stockées dans la couche d’analyse de réseau en entrée. Si la couche d’analyse de réseau a des remplacements de paramètres de localisation pour la sous-couche sélectionnée, ces paramètres seront utilisés. Sinon, les paramètres de localisation par défaut de la couche d’analyse de réseau seront utilisés. La définition d’une valeur différente de la valeur par défaut pour ce paramètre met à jour les remplacements de paramètres de localisation de la couche d’analyse de réseau pour la sous-couche sélectionnée.

Ce paramètre n’est pas utilisé lorsque vous ajoutez des localisations qui utilisent des champs de localisation de réseau existants.

Ce paramètre n’est pas utilisé lorsque la source de données de réseau de la couche d’analyse de réseau est ArcGIS Online.

Héritage :

Ce paramètre n’est pas utilisé lorsque la source de données de réseau de la couche d’analyse de réseau est un portail exécutant une version de ArcGIS Enterprise antérieure à la version 11.0.

Value Table
allow_auto_relocate
(Facultatif)

Indique si les entrées avec des champs de localisation de réseau existant peuvent être automatiquement déplacées lors du calcul afin de garantir que les champs de localisation sont valides et accessibles pour l’analyse.

  • ALLOWLes points situés sur des éléments de réseau restreints et les points concernés par des interruptions seront déplacés vers la localisation accessible la plus proche au moment du calcul. Il s’agit de l’option par défaut.
  • NO_ALLOWLes champs de localisation de réseau seront utilisés tels quels au moment du calcul, même si les points sont inaccessibles. Cela peut provoquer un échec du calcul.

La valeur par défaut de ce paramètre est déterminée en fonction des propriétés de localisation stockées dans la couche d’analyse de réseau en entrée. Si la couche d’analyse de réseau a des remplacements de paramètres de localisation pour la sous-couche sélectionnée, ces paramètres seront utilisés. Sinon, les paramètres de localisation par défaut de la couche d’analyse de réseau seront utilisés. La définition d’une valeur différente de la valeur par défaut pour ce paramètre met à jour les remplacements de paramètres de localisation de la couche d’analyse de réseau pour la sous-couche sélectionnée.

Même si la relocalisation automatique au moment du calcul n’est pas autorisée, les entrées sans champs de localisation ou avec des champs de localisation incomplets seront localisées au moment du calcul.

Ce paramètre n’est pas utilisé lorsque la source de données de réseau de la couche d’analyse de réseau est ArcGIS Online.

Ce paramètre n’est pas utilisé lorsque la source de données de réseau de la couche d’analyse de réseau est un portail ArcGIS Enterprise qui ne prend pas en charge l’utilisation des champs de localisation de réseau.

Héritage :

Ce paramètre n’est pas utilisé lorsque la source de données de réseau de la couche d’analyse de réseau est un portail exécutant une version de ArcGIS Enterprise antérieure à la version 11.0.

Boolean

Sortie obtenue

NomExplicationType de données
output_layer

La couche d’analyse de réseau mise à jour.

Network Analyst Layer

Exemple de code

Exemple 1 d'utilisation de l'outil Ajouter des localisations (fenêtre Python)

Exécutez l’outil dans la fenêtre Python pour ajouter des arrêts à une couche d’analyse d’itinéraires nommée Route.

import arcpy
hospitals = "C:/Data/SanFrancisco.gdb/Analysis/Hospitals"
arcpy.na.AddLocations("Route", "Stops", hospitals)
Exemple 2 d’utilisation de l’outil Add Locations (Ajouter des localisations) (workflow)

Le script Python autonome suivant illustre comment utiliser la fonction AddLocations pour charger les origines et les destinations dans une couche de matrice de coût OD.

Héritage :

La fonction GetNASublayer peut être utilisée pour extraire les sous-couches d’une couche d’analyse de réseau. Elle a été introduite dans ArcGIS Pro 2.7. Dans les versions précédentes, la meilleure manière d’extraire un objet de sous-couche d’une couche d’analyse de réseau consistait à utiliser la méthode listLayers de l’objet Layer d’analyse de réseau en utilisant le nom de la sous-couche en tant que caractère générique.

# Name: AddLocations_Workflow.py
# Description: Calculate a travel time matrix between stores. Use the Add
#               Locations tool to load origins and destinations into an OD Cost
#               Matrix layer. Since the origins and destinations are the same in
#               this case, the origins are first loaded from the stores feature
#               class using geometry, and the destinations are loaded from the
#               origins using network location fields in order to speed up the
#               load times.
# Requirements: Network Analyst Extension

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

try:
    # Check out Network Analyst license if available. Fail if the Network Analyst license is not available.
    if arcpy.CheckExtension("network") == "Available":
        arcpy.CheckOutExtension("network")
    else:
        raise arcpy.ExecuteError("Network Analyst Extension license is not available.")

    # 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 inputs and outputs
    input_gdb = "C:/Data/SanFrancisco.gdb"
    network = os.path.join(input_gdb, "Transportation", "Streets_ND")
    layer_name = "StoreTravelTimeMatrix"
    travel_mode = "Driving Time"
    stores = os.path.join(input_gdb, "Analysis", "Stores")
    search_tolerance = "500 Meters"
    search_query = [["Streets", '"FREEWAY" = 0'], ["Streets_ND_Junctions", ""]]
    output_layer_file = os.path.join(output_dir, layer_name + ".lyrx")

    # Create a new OD cost matrix analysis layer. For this scenario, the default
    # value for all the remaining parameters statisfies the analysis requirements
    result_object = arcpy.na.MakeODCostMatrixAnalysisLayer(
        network, layer_name, travel_mode
    )

    # Get the layer object from the result object. The OD cost matrix layer can
    # now be referenced using the layer object.
    layer_object = result_object.getOutput(0)

    # Get the names of all the sublayers within the OD layer.
    sublayer_names = arcpy.na.GetNAClassNames(layer_object)
    # Store the layer names for later use
    origins_layer_name = sublayer_names["Origins"]
    destinations_layer_name = sublayer_names["Destinations"]

    # Load store features as origins using the geometry of store features.
    # Ensure that the stores are not located on freeways by using a search query.
    arcpy.na.AddLocations(
        layer_object, origins_layer_name, stores, "",
        search_tolerance, search_query=search_query
    )

    # Because we want our origins and destinations to be the same, load the
    # origins as destinations using the network locations fields. Loading using
    # existing network location fields is much faster than loading using geometry
    # because the network locations have already been calculated.
    # Create a field mappings object that supports network location fields using
    # the candidate fields from origins
    origins_sublayer = arcpy.na.GetNASublayer(layer_object, "Origins")
    candidate_fields = arcpy.ListFields(origins_sublayer)
    field_mappings = arcpy.na.NAClassFieldMappings(
        layer_object, destinations_layer_name, True, candidate_fields
    )
    arcpy.na.AddLocations(
        layer_object, destinations_layer_name, origins_sublayer, field_mappings
    )

    # Solve the od cost matrix layer. Halt the execution if there is an
    # invalid location
    arcpy.na.Solve(layer_object, "HALT")

    # Save the solved OD cost matrix 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))