Calculer les emplacements (Network Analyst)

Synthèse

Localise des entités en entrée sur un réseau et ajoute des champs décrivant ces localisations de réseau aux entités en entrée. Cet outil permet de précalculer les localisations de réseau des entrées qui seront utilisées dans un processus Network Analyst, améliorant ainsi les performances de l’analyse au moment du calcul. L’outil enregistre les localisations de réseau calculées pour les entrées dans des champs des données en entrée.

Pour en savoir plus sur la localisation d’entités sur un réseau

En savoir plus sur le précalcul des localisations de réseau

Utilisation

  • Par défaut, cet outil enregistre les localisations de réseau calculées dans un ensemble de champs avec les noms de champs de localisation de réseau reconnus par tous les processus Network Analyst. Vous pouvez néanmoins modifier les noms des champs dans lesquels sont enregistrées les localisations de réseau calculées. Dans ce cas, lorsque vous utilisez les localisations de réseau précalculées dans un processus, utilisez l’appariement de champs pour apparier les champs de localisation autres que les champs par défaut aux propriétés de localisation de réseau adéquates.

    La seule raison qui pourrait vous pousser à modifier les noms des champs est l’enregistrement d’un ensemble séparé de champs de localisation pour différents réseaux ou modes de déplacement dans la même classe d’entités. Sinon, utilisez toujours les noms des champs par défaut.

    Vous pouvez spécifier les noms de champs différents à l’aide des paramètres Source ID Field (Champ ID de la source), Source OID Field (Champ OID de la source), Percent Along Field (Champ Pourcentage), Side of Edge Field (Champ Côté du tronçon), Located X-Coordinate Field (Champ Coordonnée X localisée), Located Y-Coordinate Field (Champ Coordonnée Y localisée), Distance from Feature Field (Champ Distance à partir de l’entité), Located Z-Coordinate Field (Champ Coordonnée Z localisée) et Location Ranges Field (Champ Plages de localisation).

  • Cet outil calcule uniquement les localisations de réseau des entrées à l’aide d’un jeu de données réseau. Il ne peut pas calculer les localisations de réseau pour un service d’analyse de réseau.

  • Si les entités en entrée correspondent à une sous-couche d’une couche d’analyse de réseau, les paramètres Search Tolerance (Tolérance de recherche), Search Criteria (Critères de recherche) et Search Query (Requête de recherche) sont automatiquement renseignés 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 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 les entités en entrée correspondent à une sous-couche d’une couche d’analyse de réseau et que 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 utilisent les paramètres de localisation que vous avez utilisés lors du calcul initial des localisations de réseau.

Paramètres

ÉtiquetteExplicationType de données
Entités en entrée

Entités en entrée pour lesquelles les localisations de réseau sont calculées.

Pour les entités linéaires et surfaciques, puisque les informations de localisation de réseau sont stockées dans un champ BLOB, seules les classes d’entités de géodatabase sont prises en charge.

Table View
Réseau d’analyse en entrée
(Facultatif)

Jeu de données réseau qui sera utilisé pour calculer les localisations.

Ce paramètre est requis, sauf si vous utilisez une sous-couche d’une couche d’analyse de réseau comme entités en entrée. Dans ce cas, le paramètre est masqué et automatiquement défini sur le jeu de données réseau référencé par la couche d’analyse de réseau.

Network Dataset Layer
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 est 5 000 mètres.

Si les entités en entrée correspondent à une sous-couche d’une couche d’analyse 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é lors du calcul de localisations pour les entités linéaires ou surfaciques.

Linear Unit
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 est pour localiser toutes les sources de réseau, sauf les jonctions de débrayage créées en exécutant l’outil Dissolve Network (Réseau de fusion) et les jonctions de système.

Si les entités en entrée correspondent à une sous-couche d’une couche d’analyse 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.

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
Champ ID de la source
(Facultatif)

Nom du champ à créer ou à mettre à jour, qui sera renseigné avec l’ID de la classe d’entités source du jeu de données réseau pour la localisation de réseau calculée pour l’entité en entrée. La valeur par défaut est SourceID.

Ce paramètre n'est pas utilisé lors du calcul de localisations pour les entités linéaires ou surfaciques.

N’utilisez pas ce paramètre lorsque les entités en entrée sont une sous-couche d’une couche d’analyse de réseau. Les localisations de réseau dans une sous-couche doivent être stockées dans des champs de localisation avec les noms par défaut. Sinon, elles ne seront pas utilisées au moment de la résolution de la couche.

Field
Champ OID de la source
(Facultatif)

Nom du champ à créer ou à mettre à jour, qui sera renseigné avec la valeur du champ ObjectID de la classe d’entités source du jeu de données réseau pour la localisation de réseau calculée pour l’entité en entrée. La valeur par défaut est SourceOID.

Ce paramètre n'est pas utilisé lors du calcul de localisations pour les entités linéaires ou surfaciques.

N’utilisez pas ce paramètre lorsque les entités en entrée sont une sous-couche d’une couche d’analyse de réseau. Les localisations de réseau dans une sous-couche doivent être stockées dans des champs de localisation avec les noms par défaut. Sinon, elles ne seront pas utilisées au moment de la résolution de la couche.

Field
Champ Pourcentage
(Facultatif)

Nom du champ à créer ou à mettre à jour pour décrire le pourcentage de la localisation de réseau calculée le long de l’élément de réseau où elle est située. La valeur par défaut est PosAlong.

Ce paramètre n'est pas utilisé lors du calcul de localisations pour les entités linéaires ou surfaciques.

N’utilisez pas ce paramètre lorsque les entités en entrée sont une sous-couche d’une couche d’analyse de réseau. Les localisations de réseau dans une sous-couche doivent être stockées dans des champs de localisation avec les noms par défaut. Sinon, elles ne seront pas utilisées au moment de la résolution de la couche.

Field
Champ Côté du tronçon
(Facultatif)

Nom du champ à créer ou à mettre à jour pour décrire le côté du tronçon de réseau sur lequel se trouve la localisation réseau calculée. La valeur par défaut est SideOfEdge.

Ce paramètre n'est pas utilisé lors du calcul de localisations pour les entités linéaires ou surfaciques.

N’utilisez pas ce paramètre lorsque les entités en entrée sont une sous-couche d’une couche d’analyse de réseau. Les localisations de réseau dans une sous-couche doivent être stockées dans des champs de localisation avec les noms par défaut. Sinon, elles ne seront pas utilisées au moment de la résolution de la couche.

Field
Champ Coordonnée X localisée
(Facultatif)

Nom du champ à créer ou à mettre à jour avec la coordonnée x de la localisation de réseau calculée. La valeur par défaut est SnapX.

Ce paramètre n'est pas utilisé lors du calcul de localisations pour les entités linéaires ou surfaciques.

N’utilisez pas ce paramètre lorsque les entités en entrée sont une sous-couche d’une couche d’analyse de réseau. Les localisations de réseau dans une sous-couche doivent être stockées dans des champs de localisation avec les noms par défaut. Sinon, elles ne seront pas utilisées au moment de la résolution de la couche.

Field
Champ Coordonnée Y localisée
(Facultatif)

Nom du champ à créer ou à mettre à jour avec la coordonnée y de la localisation de réseau calculée. La valeur par défaut est SnapY.

Ce paramètre n'est pas utilisé lors du calcul de localisations pour les entités linéaires ou surfaciques.

N’utilisez pas ce paramètre lorsque les entités en entrée sont une sous-couche d’une couche d’analyse de réseau. Les localisations de réseau dans une sous-couche doivent être stockées dans des champs de localisation avec les noms par défaut. Sinon, elles ne seront pas utilisées au moment de la résolution de la couche.

Field
Champ Distance à partir de l’entité
(Facultatif)

Nom du champ à créer ou à mettre à jour pour décrire la distance en mètres de l’entité ponctuelle d’origine par rapport à sa localisation réseau calculée. La valeur par défaut est DistanceToNetworkInMeters.

Ce paramètre n'est pas utilisé lors du calcul de localisations pour les entités linéaires ou surfaciques.

N’utilisez pas ce paramètre lorsque les entités en entrée sont une sous-couche d’une couche d’analyse de réseau. Les localisations de réseau dans une sous-couche doivent être stockées dans des champs de localisation avec les noms par défaut. Sinon, elles ne seront pas utilisées au moment de la résolution de la couche.

Field
Champ des coordonnées Z localisées
(Facultatif)

Nom du champ à créer ou à mettre à jour avec la coordonnée z de la localisation de réseau calculée. La valeur par défaut est SnapZ.

Ce paramètre est uniquement utilisé lorsque le jeu de données réseau en entrée prend en charge la connectivité selon les coordonnées z des sources de réseau.

Ce paramètre n'est pas utilisé lors du calcul de localisations pour les entités linéaires ou surfaciques.

N’utilisez pas ce paramètre lorsque les entités en entrée sont une sous-couche d’une couche d’analyse de réseau. Les localisations de réseau dans une sous-couche doivent être stockées dans des champs de localisation avec les noms par défaut. Sinon, elles ne seront pas utilisées au moment de la résolution de la couche.

Field
Champ Plages de localisation
(Facultatif)

Nom du champ à créer ou à mettre à jour avec les plages des localisations de réseau calculées pour les entités linéaires ou surfaciques. La valeur par défaut est Locations.

Ce paramètre est utilisé uniquement lors du calcul de localisations pour les entités linéaires ou surfaciques.

N’utilisez pas ce paramètre lorsque les entités en entrée sont une sous-couche d’une couche d’analyse de réseau. Les localisations de réseau dans une sous-couche doivent être stockées dans des champs de localisation avec les noms par défaut. Sinon, elles ne seront pas utilisées au moment de la résolution de la couche.

Field
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).

Par défaut, aucune requête n’est utilisée pour une source.

Si les entités en entrée correspondent à une sous-couche d’une couche d’analyse 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.

Value Table
Mode de déplacement
(Facultatif)

Nom du mode de déplacement qui sera utilisé.

Si vous sélectionnez un mode de déplacement, les paramètres du mode de déplacement, tels que les restrictions et les attributs d’impédance, seront pris en compte lors du calcul de la localisation réseau. Par exemple, si le tronçon de réseau le plus proche d’un des points en entrée est restreint lorsque le mode de déplacement sélectionné est appliqué, l’outil localise le point sur le tronçon de réseau suivant le plus proche qui n’est pas restreint.

Les modes de déplacement disponibles dépendent de la valeur du paramètre Input Analysis Network (Réseau d’analyse en entrée).

Si une sous-couche d’une couche d’analyse de réseau est utilisée en tant qu’entité en entrée, ce paramètre est masqué et ne doit pas être utilisé. Lors du calcul des localisations de réseau, le mode de déplacement actuel de la couche d’analyse de réseau est automatiquement utilisé.

String

Sortie obtenue

ÉtiquetteExplicationType de données
Entités en entrée mises à jour

Entités en entrée mises à jour.

Table View
Couche Network Analyst

Si la valeur du paramètre Input Features (Entités en entrée) correspond à une sous-couche d’une couche d’analyse de réseau, ce paramètre en sortie dérivé renvoie la couche d’analyse de réseau parent de la sous-couche. Sinon, aucune valeur n’est renvoyée.

Network Analyst Layer

arcpy.management.CalculateLocations(in_point_features, {in_network_dataset}, {search_tolerance}, {search_criteria}, {match_type}, {source_ID_field}, {source_OID_field}, {position_field}, {side_field}, {snap_X_field}, {snap_Y_field}, {distance_field}, {snap_Z_field}, {location_field}, {exclude_restricted_elements}, {search_query}, {travel_mode})
NomExplicationType de données
in_point_features

Entités en entrée pour lesquelles les localisations de réseau sont calculées.

Pour les entités linéaires et surfaciques, puisque les informations de localisation de réseau sont stockées dans un champ BLOB, seules les classes d’entités de géodatabase sont prises en charge.

Table View
in_network_dataset
(Facultatif)

Jeu de données réseau qui sera utilisé pour calculer les localisations.

Ce paramètre est requis, sauf si vous utilisez une sous-couche d’une couche d’analyse de réseau comme entités en entrée. Dans ce cas, n’indiquez pas de valeur pour ce paramètre ou définissez-le sur le jeu de données réseau référencé par la couche d’analyse de réseau.

Network Dataset Layer
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 est 5 000 mètres.

Si les entités en entrée correspondent à une sous-couche d’une couche d’analyse 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é lors du calcul de localisations pour les entités linéaires ou surfaciques.

Linear Unit
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 est pour localiser toutes les sources de réseau, sauf les jonctions de débrayage créées en exécutant l’outil Dissolve Network (Réseau de fusion) et les jonctions de système.

Si les entités en entrée correspondent à une sous-couche d’une couche d’analyse 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.

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
source_ID_field
(Facultatif)

Nom du champ à créer ou à mettre à jour, qui sera renseigné avec l’ID de la classe d’entités source du jeu de données réseau pour la localisation de réseau calculée pour l’entité en entrée. La valeur par défaut est SourceID.

Ce paramètre n'est pas utilisé lors du calcul de localisations pour les entités linéaires ou surfaciques.

N’utilisez pas ce paramètre lorsque les entités en entrée sont une sous-couche d’une couche d’analyse de réseau. Les localisations de réseau dans une sous-couche doivent être stockées dans des champs de localisation avec les noms par défaut. Sinon, elles ne seront pas utilisées au moment de la résolution de la couche.

Field
source_OID_field
(Facultatif)

Nom du champ à créer ou à mettre à jour, qui sera renseigné avec la valeur du champ ObjectID de la classe d’entités source du jeu de données réseau pour la localisation de réseau calculée pour l’entité en entrée. La valeur par défaut est SourceOID.

Ce paramètre n'est pas utilisé lors du calcul de localisations pour les entités linéaires ou surfaciques.

N’utilisez pas ce paramètre lorsque les entités en entrée sont une sous-couche d’une couche d’analyse de réseau. Les localisations de réseau dans une sous-couche doivent être stockées dans des champs de localisation avec les noms par défaut. Sinon, elles ne seront pas utilisées au moment de la résolution de la couche.

Field
position_field
(Facultatif)

Nom du champ à créer ou à mettre à jour pour décrire le pourcentage de la localisation de réseau calculée le long de l’élément de réseau où elle est située. La valeur par défaut est PosAlong.

Ce paramètre n'est pas utilisé lors du calcul de localisations pour les entités linéaires ou surfaciques.

N’utilisez pas ce paramètre lorsque les entités en entrée sont une sous-couche d’une couche d’analyse de réseau. Les localisations de réseau dans une sous-couche doivent être stockées dans des champs de localisation avec les noms par défaut. Sinon, elles ne seront pas utilisées au moment de la résolution de la couche.

Field
side_field
(Facultatif)

Nom du champ à créer ou à mettre à jour pour décrire le côté du tronçon de réseau sur lequel se trouve la localisation réseau calculée. La valeur par défaut est SideOfEdge.

Ce paramètre n'est pas utilisé lors du calcul de localisations pour les entités linéaires ou surfaciques.

N’utilisez pas ce paramètre lorsque les entités en entrée sont une sous-couche d’une couche d’analyse de réseau. Les localisations de réseau dans une sous-couche doivent être stockées dans des champs de localisation avec les noms par défaut. Sinon, elles ne seront pas utilisées au moment de la résolution de la couche.

Field
snap_X_field
(Facultatif)

Nom du champ à créer ou à mettre à jour avec la coordonnée x de la localisation de réseau calculée. La valeur par défaut est SnapX.

Ce paramètre n'est pas utilisé lors du calcul de localisations pour les entités linéaires ou surfaciques.

N’utilisez pas ce paramètre lorsque les entités en entrée sont une sous-couche d’une couche d’analyse de réseau. Les localisations de réseau dans une sous-couche doivent être stockées dans des champs de localisation avec les noms par défaut. Sinon, elles ne seront pas utilisées au moment de la résolution de la couche.

Field
snap_Y_field
(Facultatif)

Nom du champ à créer ou à mettre à jour avec la coordonnée y de la localisation de réseau calculée. La valeur par défaut est SnapY.

Ce paramètre n'est pas utilisé lors du calcul de localisations pour les entités linéaires ou surfaciques.

N’utilisez pas ce paramètre lorsque les entités en entrée sont une sous-couche d’une couche d’analyse de réseau. Les localisations de réseau dans une sous-couche doivent être stockées dans des champs de localisation avec les noms par défaut. Sinon, elles ne seront pas utilisées au moment de la résolution de la couche.

Field
distance_field
(Facultatif)

Nom du champ à créer ou à mettre à jour pour décrire la distance en mètres de l’entité ponctuelle d’origine par rapport à sa localisation réseau calculée. La valeur par défaut est DistanceToNetworkInMeters.

Ce paramètre n'est pas utilisé lors du calcul de localisations pour les entités linéaires ou surfaciques.

N’utilisez pas ce paramètre lorsque les entités en entrée sont une sous-couche d’une couche d’analyse de réseau. Les localisations de réseau dans une sous-couche doivent être stockées dans des champs de localisation avec les noms par défaut. Sinon, elles ne seront pas utilisées au moment de la résolution de la couche.

Field
snap_Z_field
(Facultatif)

Nom du champ à créer ou à mettre à jour avec la coordonnée z de la localisation de réseau calculée. La valeur par défaut est SnapZ.

Ce paramètre est uniquement utilisé lorsque le jeu de données réseau en entrée prend en charge la connectivité selon les coordonnées z des sources de réseau.

Ce paramètre n'est pas utilisé lors du calcul de localisations pour les entités linéaires ou surfaciques.

N’utilisez pas ce paramètre lorsque les entités en entrée sont une sous-couche d’une couche d’analyse de réseau. Les localisations de réseau dans une sous-couche doivent être stockées dans des champs de localisation avec les noms par défaut. Sinon, elles ne seront pas utilisées au moment de la résolution de la couche.

Field
location_field
(Facultatif)

Nom du champ à créer ou à mettre à jour avec les plages des localisations de réseau calculées pour les entités linéaires ou surfaciques. La valeur par défaut est Locations.

Ce paramètre est utilisé uniquement lors du calcul de localisations pour les entités linéaires ou surfaciques.

N’utilisez pas ce paramètre lorsque les entités en entrée sont une sous-couche d’une couche d’analyse de réseau. Les localisations de réseau dans une sous-couche doivent être stockées dans des champs de localisation avec les noms par défaut. Sinon, elles ne seront pas utilisées au moment de la résolution de la couche.

Field
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.

Par défaut, aucune requête n’est utilisée pour une source.

Si les entités en entrée correspondent à une sous-couche d’une couche d’analyse 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.

Value Table
travel_mode
(Facultatif)

Nom du mode de déplacement qui sera utilisé.

Si vous sélectionnez un mode de déplacement, les paramètres du mode de déplacement, tels que les restrictions et les attributs d’impédance, seront pris en compte lors du calcul de la localisation réseau. Par exemple, si le tronçon de réseau le plus proche d’un des points en entrée est restreint lorsque le mode de déplacement sélectionné est appliqué, l’outil localise le point sur le tronçon de réseau suivant le plus proche qui n’est pas restreint.

Les modes de déplacement disponibles dépendent de la valeur du paramètre in_network_dataset.

Vous pouvez aussi utiliser un objet arcpy.na.TravelMode et une chaîne contenant la représentation JSON valide d’un mode de déplacement en entrée du paramètre.

Si une sous-couche d’une couche d’analyse du réseau est utilisée en tant qu’entité en entrée, ne définissez pas de valeur pour ce paramètre. Lors du calcul des localisations de réseau, le mode de déplacement actuel de la couche d’analyse de réseau est automatiquement utilisé.

String

Sortie obtenue

NomExplicationType de données
out_point_feature_class

Entités en entrée mises à jour.

Table View
output_layer

Si la valeur du paramètre in_point_features correspond à une sous-couche d’une couche d’analyse de réseau, ce paramètre en sortie dérivé renvoie la couche d’analyse de réseau parent de la sous-couche. Sinon, aucune valeur n’est renvoyée.

Network Analyst Layer

Exemple de code

Exemple 1 d'utilisation de l'outil Calculer les localisations (fenêtre Python)

Calculez des localisations pour des entités ponctuelles.

stores = "C:/Data/SanFrancisco.gdb/Analysis/Hospitals/Analysis/Stores"
network = "C:/Data/SanFrancisco.gdb/Transportation/Streets_ND"
arcpy.na.CalculateLocations(stores, network, "5000 Meters",
                            [["Streets", "SHAPE"],
                            ["Streets_ND_Junctions", "NONE"]])
Exemple 2 d’utilisation de l’outil Calculate Locations (Calculer les localisations) (processus)

L’exemple de code suivant montre l’utilisation de la fonction CalculateLocations pour précalculer les localisations de réseau et l’utilisation de ces localisations de réseau précalculées dans un processus arcpy.nax.

Le paramètre use_location_fields dans la méthode fieldMappings est défini sur True (Vrai) pour s’assurer que les champs de localisation de réseau précalculés sont utilisés lors du chargement des entrées d’analyse. De plus, les champs de localisation de réseau sont calculés à l’aide des mêmes paramètres de jeu de données réseau, de mode de déplacement et de localisation que ceux utilisés dans l’analyse de la zone de desserte pour s’assurer que les résultats sont valides et cohérents.

"""Precalculate network locations with the Calculate Locations
geoprocessing tool, then run a Service Area workflow using
the arcpy.nax solver object. Map the precalculated network
locations using fieldMappings and load.
"""
import arcpy

arcpy.CheckOutExtension("network")

network = "C:/Data/Paris.gdb/Transportation/ParisMultimodal_ND"
input_facilities = "C:/Data/Paris.gdb/Analysis/Stores"
travel_mode = "Driving Time"

# Make a network dataset layer
nd_layer = arcpy.nax.MakeNetworkDatasetLayer(network).getOutput(0)

# Run Calculate Locations to calculate the network locations of
# the points in the input feature class. Use the same network,
# travel mode, and locate settings that will be used in the
# network analysis.
# Set a search_tolerance of 500 meters.
# Use search_criteria to locate only on streets and metro entrances.
# Use search_query to prevent locating on highways (FUNC_CLASS 1)
arcpy.nax.CalculateLocations(
    input_facilities,
    nd_layer,
    search_tolerance="500 Meters",
    search_criteria=[
        ["Streets", "SHAPE"],
        ["Metro_Lines", "NONE"],
        ["Transfer_Stations", "NONE"],
        ["Transfer_Street_Station", "NONE"],
        ["Metro_Entrances", "SHAPE"],
        ["Metro_Stations", "NONE"],
        ["ParisMultimodal_ND_Junctions", "NONE"]
    ],
    search_query=[["Streets", "FUNC_CLASS <> '1'"]],
    travel_mode=travel_mode
)

# Initialize the Service Area solver object
service_area = arcpy.nax.ServiceArea(nd_layer)

# Set the analysis properties. Use the same travel mode and
# locate settings that were used when precalculating the
# network locations
service_area.travelMode = travel_mode
service_area.searchTolerance = 500
service_area.searchToleranceUnits = arcpy.nax.DistanceUnits.Meters
service_area.searchSources = [
    ["Streets", "FUNC_CLASS <> '1'"],
    ["Metro_Entrances", "SHAPE"]
]
service_area.defaultImpedanceCutoffs = [5, 10]

# Construct a field mapping object with network location fields
field_mappings = service_area.fieldMappings(
    arcpy.nax.ServiceAreaInputDataType.Facilities,
    use_location_fields=True
)

# Load the input data using the field mappings
# Location fields are included automatically because
# of the field mappings.
service_area.load(
    arcpy.nax.ServiceAreaInputDataType.Facilities,
    input_facilities,
    field_mappings
)

# Solve the analysis
result = service_area.solve()
print(result.solveSucceeded)

# ...analysis of the results continues...