Fonctions ArcGIS for Excel

Remarque :

Vous devez vous connecter à un compte ArcGIS pour utiliser les fonctions ArcGIS for Excel. Si vous n’êtes pas connecté, une erreur de connexion apparaît lorsque vous survolez le triangle vert dans le coin supérieur gauche d’une cellule sélectionnée. Dans Microsoft Windows Desktop ou macOS, une icône d’avertissement jaune apparaît également.

Microsoft Excel comprend un ensemble de fonctions ou de formules permettant de calculer différentes informations allant de simples sommes arithmétiques au renseignement complexe de cellules.

ArcGIS for Excel comprend des fonctions similaires adaptées aux opérations de géocodage, d’enrichissement des données et de calcul d’itinéraire. Chaque fonction commence par un signe égal (=) dans une cellule, suivi du nom de la fonction et de ses paramètres en entrée (le cas échéant), entre parenthèses.

Conseil :

Lorsque vous écrivez une fonction dans une cellule, vous pouvez utiliser les références de cellule en sélectionnant une ou plusieurs cellules spécifiques dans une colonne ou une ligne. Cela garantit l’intégrité des données. Consultez l’article Microsoft Créer ou modifier une référence de cellule pour plus d’informations.

Remarque :

Les fonctions GeoEnrichment Service, de géocodage et de calcul d’itinéraire consomment des crédits. Les fonctions géométriques ne consomment pas de crédits. La fonction SUGGESTADDRESS consomme des crédits lorsque vous demandez plus de 15 suggestions. Les fonctions d’assistance ne consomment pas de crédits. Les fonctions ArcGIS sont mises en cache afin d’éviter la consommation de crédits supplémentaires si et quand elles sont actualisées. Ce cache augmente la taille de votre fichier Microsoft Excel. Pour effacer la cache des fonctions ArcGIS for Excel, cliquez sur le bouton Clear cache (Effacer le cache) dans la fenêtre Settings (Paramètres).

Vous pouvez copier les exemples de cette rubrique dans une feuille de calcul Excel pour visualiser le fonctionnement des fonctions. Vous pouvez également utiliser les fonctions ArcGIS for Excel dans l’outil ArcGIS Function Builder (Générateur de fonctions ArcGIS).

Certaines fonctions ArcGIS sont susceptibles d’échouer avec une erreur indiquant que le service n’est pas disponible lorsque vous les exécutez au sein d’une cellule dans Excel. Contactez l’administrateur de votre organisation pour activer le service ou pour obtenir plus d’informations.

Pour plus d’informations sur les services, reportez-vous à la documentation de ArcGIS Enterprise et de ArcGIS Online.

Les sections suivantes décrivent les fonctions ArcGIS for Excel et incluent la syntaxe, un exemple et des descriptions des paramètres.

Remarque :

Dans les exemples de fonctions ci-dessous, le résultat réel des fonctions exclut l’en-tête. Exécutez la fonction ADDHEADERS pour demander les en-têtes.

GETCOORDINATES

Il s’agit d’une fonction Geocoding (Géocodage). Géocoder un emplacement. Renvoie les localisations possibles, y compris la longitude, la latitude et éventuellement l’adresse appariée et le score d’appariement.

Syntaxe

ARCGIS.GETCOORDINATES(address, [spatial_reference], [match_details], [geocode_service])

Paramètres

Paramètre	Description	Paramètre requis
adresse	La localisation à géocoder. Il peut s’agir d’une adresse postale, d’un nom de lieu, d’un code postal ou d’un point d’intérêt.	Oui
référence spatiale	Référence spatiale de la localisation du point. Il peut s’agir d’un WKID (nombre) ou d’un WKT (texte). Reportez-vous à la liste des valeurs de WKID valides. La valeur par défaut est 4326 (WGS84).	Non
match_details	Si ce paramètre est défini sur TRUE, non seulement la longitude et la latitude sont renvoyées, mais également le nom de l’adresse du point apparié et le score d’appariement. La valeur par défaut est FALSE.	Non
geocode_service	Sélectionnez un service de géocodage dans le menu déroulant. Le service répertorie tous les localisateurs disponibles pour les membres de votre organisation.	Non

Remarque :

Dans tous les exemples de fonctions, le résultat réel des fonctions exclut l’en-tête. Exécutez la fonction ADDHEADERS pour demander les en-têtes.

Exemple de fonction 1

=ARCGIS.GETCOORDINATES("380 New York Street, Redlands, CA, USA")

Résultat

Longitude (X)	Latitude (Y)
-117.19479	34.057265

Exemple de fonction 2

=ARCGIS.GETCOORDINATES("380 New York Street, Redlands, CA, USA", 4326 , TRUE)

Résultat

Longitude (X)	Latitude (Y)	Adresse	Score d’appariement	Géolocalisateur	Type d’adresse
-117.1948	34.057265	380 New York St, Redlands, CA, 92373, États-Unis	100	Monde	PointAddress

GETADDRESS

Il s’agit d’une fonction Geocoding (Géocodage). Détermine l’adresse correspondant à des valeurs de longitude/latitude données via le géocodage inverse.

Syntaxe

ARCGIS.GETADDRESS(longitude(X), latitude(Y), [spatial_reference], [all_data], [geocode_service])

Paramètres

Paramètre	Description	Paramètre requis
longitude(X)	Longitude du point à partir duquel rechercher l’adresse la plus proche.	Oui
latitude(Y)	Latitude du point à partir duquel rechercher l’adresse la plus proche.	Oui
référence spatiale	Référence spatiale de la localisation du point. Il peut s’agir d’un WKID (nombre) ou d’un WKT (texte). Reportez-vous à la liste des valeurs de WKID valides. La valeur par défaut est 4326 (WGS84).	Non
all_data	Si ce paramètre est défini sur TRUE, non seulement le nom de l’adresse de géocodage inversé est renvoyé, mais également toutes les propriétés de l’adresse comme la ville ou la région. La valeur par défaut est FALSE.	Non
geocode_service	Sélectionnez un service de géocodage dans le menu déroulant. Le service répertorie tous les localisateurs disponibles pour les membres de votre organisation.	Non

Exemple de fonction 1

=ARCGIS.GETADDRESS(-70.251, 43.65808)

Résultat

Adresse
Standard Baking, 75 Commercial St, Portland, ME, 04101, États-Unis

Exemple de fonction 2

=ARCGIS.GETADDRESS(-70.251, 43.65808, 4326, TRUE)

Résultat

Adresse appariée	Nom complet de l’adresse	Nom court de l’adresse	Type d’adresse	Type	Nom de lieu	Numéro de rue	Nom de rue	Bloquer	Secteur	Quartier	Arrondissement	Ville	Zone urbaine	Sous-région	Région	Abréviation de région	Territoire	Code postal	Extension du code postal	Pays	Code de pays
Standard Baking	Standard Baking, 75 Commercial St, Portland, ME, 04101, États-Unis	Standard Baking	PI	Boulangerie	Standard Baking	75	75 Commercial St.					Portland		Comté de Cumberland	Maine	ME		04101		États-Unis	États-Unis

ENRICHBYPOINT

Il s’agit d’une fonction GeoEnrichment (Géoenrichissement). Bénéficiez d’informations démographiques enrichies sur les gens, les lieux et les commerces dans une zone spécifique ou à une certaine distance ou un temps de conduite donné par rapport à une localisation. La distance par défaut se trouve dans un rayon d’un mile du point.

Syntaxe

ARCGIS.ENRICHBYPOINT(longitude(X), latitude(Y), [spatial_reference], [distance], [unit],[travel_mode],[data_collections],[variables],[include_derivative_variables], [include_studyarea_details])

Paramètres

Paramètre	Description	Paramètre requis
longitude(X)	Longitude du point d’intérêt.	Oui
latitude(Y)	Latitude du point d’intérêt.	Oui
spatial_reference	Référence spatiale de la localisation du point. Il peut s’agir d’un WKID (nombre) ou d’un WKT (texte). Reportez-vous à la liste des valeurs de WKID valides. La valeur par défaut est 4326 (WGS84).	Non
distance	Rayon ou distance à partir du point qui est utilisé pour calculer la zone tampon en anneau des données démographiques. Par exemple, 3 pour un rayon de trois miles. La valeur par défaut est 1.	Non
unité	Unité de mesure du paramètre distance. Ce paramètre peut être exprimé en mètres, kilomètres, pieds, yards, miles ou milles nautiques. Si le paramètre travel_mode est défini, il peut également s’agir de secondes, minutes ou heures. La valeur par défaut est miles.	Non
travel_mode	Si ce paramètre est défini, il calcule une zone à l’aide de la distance de trajet à partir du point d’intérêt. Il peut s’agir du trajet à pied, en voiture ou en camion. Si cette fonction n’est pas renseignée, une zone tampon en anneau est calculée.	Non
data_collections	Listes préassemblées d’attributs qui serviront à enrichir les entités en entrée. Exécutez la fonction LISTDATACOLLECTIONS pour demander une liste des collections de données. Par exemple, utilisez KeyUSFacts, KeyGlobalFacts. La valeur par défaut est KeyGlobalFacts.	Non
analysis_variables	Variables à renvoyer à partir des collections de données (par exemple, KeyGlobalFacts.TOTPOP, AGE.MALE5). Si cette fonction n’est pas renseignée, toutes les variables de la collection de données KeyGlobalFacts sont demandées. Exécutez la fonction LISTDATACOLLECTIONS pour demander une liste des variables ou examinez l’outil de recherche de collections de données pour afficher une liste des variables.	Non
include_derivative_variables	Variables dérivées à inclure dans la sortie. Ce paramètre peut prendre la valeur d’un pourcentage, d’un index, d’une moyenne ou de tout. Si cette fonction n’est pas renseignée, aucune variable dérivée n’est incluse.	Non
include_studyarea_details	Si ce paramètre est défini sur TRUE, les informations de la zone d’étude associée, telles que la méthode de mesure du rayon et de la distance utilisée pour calculer la zone pertinente autour du point, sont incluses. La valeur par défaut est FALSE.	Non

Exemple de fonction 1

=ARCGIS.ENRICHBYPOINT(-90.491, 38.777)

Résultat

Population totale	Nombre total de ménages	Taille moyenne du ménage	Population masculine	Population féminine
11 464	4 860	1,98	5 745	5 719

Remarque :

Dans tous les exemples de fonctions, le résultat réel des fonctions exclut l’en-tête. Exécutez la fonction ADDHEADERS pour demander les en-têtes.

Exemple de fonction 2

=ARCGIS.ENRICHBYPOINT(-90.491, 38.777, 4326, 5, "miles", "driving", "health", "X8001_X, X8021_X", "index", TRUE)

Résultat

Code de pays	Type de zone	Alias d’unités de zone tampon	Rayons de zone tampon	Santé en 2022	Santé en 2022 : index	Services dentaires en 2022	Services dentaires en 2022 : index
Américain	NetworkServiceArea	Distance à parcourir en miles	5	240971277	99	15463985	99

ENRICHBYGEOGRAPHY

Il s’agit d’une fonction GeoEnrichment (Géoenrichissement). Recevez des informations sur les personnes, les lieux et les commerces dans les limites administratives nommées, ou les niveaux de géographie, d’une carte (districts, états ou codes postaux).

Syntaxe

ARCGIS.ENRICHBYGEOGRAPHY(area_id, geography_level_id, [data_collections], [variables], [include_derivative_variables], [include_geography_details])

Paramètres

Paramètre	Description	Paramètre requis
area_id	ID FIPS de la zone où seront obtenues les informations démographiques. Exécutez la fonction LISTGEOGRAPHIES pour demander une liste des ID de zones disponibles pour un niveau géographique donné. Par exemple "06" pour l’État de Californie.	Oui
geography_level_id	ID du niveau géographique auquel l’ID de zone appartient. Exécutez la fonction LISTGEOGRAPHIES pour demander une liste des ID de zone pour un niveau géographique donné. Par exemple, "US.States" correspond aux États des États-Unis.	Oui
data_collections	Listes préassemblées d’attributs qui servent à enrichir les entités en entrée. Exécutez la fonction LISTDATACOLLECTIONS pour demander une liste des collections de données. Par exemple : "KeyUSFacts, KeyGlobalFacts". La valeur par défaut est KeyGlobalFacts.	Non
analysis_variables	Variables à renvoyer à partir des collections de données (par exemple, KeyGlobalFacts.TOTPOP, AGE.MALE5). Si cette fonction n’est pas renseignée, toutes les variables de la collection de données KeyGlobalFacts sont demandées. Exécutez la fonction LISTDATACOLLECTIONS pour demander une liste des variables ou examinez l’outil de recherche de collections de données pour afficher une liste des variables.	Non
include_derivative_variables	Variables dérivées à inclure dans la sortie. Ce paramètre peut prendre la valeur d’un pourcentage, d’un index, d’une moyenne ou de tout. Si cette fonction n’est pas renseignée, aucune variable dérivée n’est incluse.	Non
include_geography_details	Si ce paramètre est défini sur TRUE, les informations géographiques associées, telles que le code de pays, le niveau géographique et l’ID de zone, sont incluses. La valeur par défaut est FALSE.	Non

Exemple de fonction 1

=ARCGIS.ENRICHBYGEOGRAPHY("06","US.States")

Résultat

Population totale	Nombre total de ménages	Taille moyenne du ménage	Population masculine	Population féminine
39770476	13570050	2.86	19767455	20003021

Exemple de fonction 2

=ARCGIS.ENRICHBYGEOGRAPHY("08019","ES.Municipalities", "IncomeTotalsAIS")

Résultat

Revenu total des ménages par an en 2020	Revenu moyen des ménages par an en 2020	Revenu moyen des ménages par mois en 2020	Revenu annuel moyen par habitant en 2020	Revenu mensuel moyen par habitant en 2020
1,99E + 10	29 898,9	2 491,57	11 938,06	994,84

Remarque :

Dans tous les exemples de fonctions, le résultat réel des fonctions exclut l’en-tête. Exécutez la fonction ADDHEADERS pour demander les en-têtes.

Exemple de fonction 3

=ARCGIS.ENRICHBYGEOGRAPHY("08019","ES.Municipalities", , "KeyGlobalFacts.AVGHHSZ, IncomeTotalsAIS.NINCHA")

Résultat

Taille moyenne du ménage	Revenu moyen des ménages par an en 2020
2.5	29 898,9

Exemple de fonction 4

=ARCGIS.ENRICHBYGEOGRAPHY("06","US.States","health", "X8001_X, X8021_X", "index", TRUE)

Résultat

Niveau géographique standard	Nom géographique standard	ID géographique standard	Code de pays	Santé en 2022	Santé en 2022 : index	Services dentaires en 2022	Services dentaires en 2022 : index
États des États-Unis	Californie	06	Américain	1.08894E+11	113	7.37E+09	119

ENRICHBYADDRESS

Il s’agit d’une fonction GeoEnrichment (Géoenrichissement). Bénéficiez d’informations démographiques enrichies sur les gens, les lieux et les commerces dans une zone spécifique ou à une certaine distance ou un temps de conduite donné par rapport à une adresse. La distance par défaut se trouve dans un rayon d’un mile du point.

Syntaxe

ARCGIS.ENRICHBYADDRESS(address, [distance], [unit],[travel_mode],[data_collections],[variables],[include_derivative_variables], [include_studyarea_details])

Paramètres

Paramètre	Description	Paramètre requis
adresse	La localisation à géocoder. Il peut s’agir d’une adresse postale, d’un nom de lieu, d’un code postal ou d’un point d’intérêt.	Oui
distance	Rayon ou distance à partir du point qui est utilisé pour calculer la zone tampon en anneau des données démographiques. Par exemple, 3 pour un rayon de trois miles. La valeur par défaut est 1.	Non
unité	Unité de mesure du paramètre distance. Ce paramètre peut être exprimé en mètres, kilomètres, pieds, yards, miles ou milles nautiques. Si le paramètre travel_mode est défini, il peut également s’agir de secondes, minutes ou heures. La valeur par défaut est miles.	Non
travel_mode	Si ce paramètre est défini, il calcule une zone à l’aide de la distance de trajet à partir du point d’intérêt. Il peut s’agir du trajet à pied, en voiture ou en camion. Si cette fonction n’est pas renseignée, une zone tampon en anneau est calculée.	Non
analysis_variables	Variables à renvoyer à partir des collections de données (par exemple, KeyGlobalFacts.TOTPOP, AGE.MALE5). Si cette fonction n’est pas renseignée, toutes les variables de la collection de données KeyGlobalFacts sont demandées. Exécutez la fonction LISTDATACOLLECTIONS pour demander une liste des variables ou examinez l’outil de recherche de collections de données pour afficher une liste des variables.	Non
include_derivative_variables	Variables dérivées à inclure dans la sortie. Ce paramètre peut prendre la valeur d’un pourcentage, d’un index, d’une moyenne ou de tout. Si cette fonction n’est pas renseignée, aucune variable dérivée n’est incluse.	Non
include_studyarea_details	Si ce paramètre est défini sur TRUE, les informations de la zone d’étude associée, telles que la méthode de mesure du rayon et de la distance utilisée pour calculer la zone pertinente autour du point, sont incluses. La valeur par défaut est FALSE.	Non

Exemple de fonction 1

=ARCGIS.ENRICHBYADDRESS("380 New York Street, Redlands, CA, USA")

Résultat

Population totale	Nombre total de ménages	Taille moyenne du ménage	Population masculine	Population féminine
11 464	4 860	1,98	5 745	5 719

Remarque :

Dans tous les exemples de fonctions, le résultat réel des fonctions exclut l’en-tête. Exécutez la fonction ADDHEADERS pour demander les en-têtes.

Exemple de fonction 2

=ARCGIS.ENRICHBYADDRESS("380 New York Street, Redlands, CA, USA", 5, "miles", "driving", "health", "X8001_X, X8021_X", "index", TRUE)

Résultat

Code de pays	Type de zone	Alias d’unités de zone tampon	Rayons de zone tampon	Santé en 2022	Santé en 2022 : index	Services dentaires en 2022	Services dentaires en 2022 : index
Américain	NetworkServiceArea	Distance à parcourir en miles	5	240971277	99	15463985	99

ENRICHBYPOLYGON

Il s’agit d’une fonction GeoEnrichment (Géoenrichissement). Obtenez des informations sur les gens, les lieux et les commerces dans une zone spécifique.

Syntaxe

ARCGIS.ENRICHBYPOLYGON (esrijson_polygon, analysis_variables, include_derivative_variables)

Paramètres

Paramètre	Description	Paramètre requis
esrijson_polygon	Polygone sous forme de géométrie EsriJSON, représentant la zone pour laquelle les informations démographiques vont être obtenues.	Oui
analysis_variables	Variables à renvoyer à partir des collections de données (par exemple, KeyGlobalFacts.TOTPOP, AGE.MALE5). Si cette fonction n’est pas renseignée, toutes les variables de la collection de données KeyGlobalFacts sont demandées. Exécutez la fonction LISTDATACOLLECTIONS pour demander une liste des variables ou examinez l’outil de recherche de collections de données pour afficher une liste des variables.	Oui
include_derivative_variables	La sortie doit contenir les variables dérivées. Le paramètre peut prendre la valeur Percentage (Pourcentage), Index, Average (Moyenne) ou All (Tout). Si cette fonction n’est pas renseignée, aucune variable dérivée n’est incluse.	Non

FINDROUTE

Il s’agit d’une fonction Routing (Calcul d’itinéraire). Recherchez la distance totale à parcourir (l’unité de mesure par défaut sont les miles) et le temps de trajet total (en minutes) entre deux localisations à l’aide du meilleur itinéraire trouvé.

Syntaxe

ARCGIS.FINDROUTE(from_longitude(X), from_latitude(Y), to_longitude(X), to_latitude(Y), [spatial_reference], [travel_mode], [unit], [include_directions])

Paramètres

Paramètre	Description	Paramètre requis
from_longitude(X)	Coordonnées de longitude du point de départ de l’itinéraire.	Oui
from_latitude(Y)	Coordonnées de latitude du point de départ de l’itinéraire.	Oui
to_longitude(X)	Coordonnées de longitude du point de destination de l’itinéraire.	Oui
to_latitude(Y)	Coordonnées de latitude du point de destination de l’itinéraire.	Oui
spatial_reference	Référence spatiale de la localisation du point. Il peut s’agir d’un WKID (nombre) ou d’un WKT (texte). Reportez-vous à la liste des valeurs de WKID valides. La valeur par défaut est 4326 (WGS84).	Non
travel_mode	Mode de déplacement de l’itinéraire. Au lieu d’une zone tampon en anneau, calculez une zone à l’aide d’un mode de déplacement. Par exemple, la marche, la conduite ou le camion. Par exemple, utilisez Distance à parcourir ou Temps de marche. Exécutez la fonction LISTTRAVELMODES pour demander une liste des modes de déplacement pris en charge. Si ce paramètre est laissé vierge, le mode de déplacement par défaut spécifié dans les paramètres de votre organisation ArcGIS est utilisé. Reportez-vous à la rubrique Configurer les modes de déplacement pour en savoir plus sur les modes de déplacement et les paramètres.	Non
unité	Unité de mesure de la distance à parcourir. Ce paramètre peut être exprimé en miles, kilomètres, mètres, pieds, points, yards ou miles nautiques. La valeur par défaut sont les miles.	Non
include_directions	Si ce paramètre est défini sur TRUE, la feuille de route vers la destination, ainsi que la durée du trajet et la distance parcourue à chaque étape sont incluses dans les résultats. La valeur par défaut est FALSE.	Non

Exemple de fonction 1

=ARCGIS.FINDROUTE(-77.24488778, 38.92894278, -80.78300851, 35.1001845)

Résultat

Distance parcourue (miles)	Durée du trajet (minutes)	Forme de l’itinéraire
391,3764	401,6001295	{"spatialReference":{"latestWkid":4326,"wkid":4326},"paths":[[[-77.244918653,38.92906864],[-77.2443203,38.9292242], ...

Remarque :

Dans tous les exemples de fonctions, le résultat réel des fonctions exclut l’en-tête. Exécutez la fonction ADDHEADERS pour demander les en-têtes.

Exemple de fonction 2

=ARCGIS.FINDROUTE(-77.24488778, 38.92894278, -80.78300851, 35.1001845, 4326, "Driving Distance", "miles", TRUE)

Résultat

Description	Distance parcourue (miles)	Durée du trajet (minutes)	Forme de l’itinéraire
Distance parcourue/durée du trajet au total	382,7767	408,1581
Démarrez à l’emplacement 1	0	0	{"spatialReference":{"wkid":4326},"paths":[[[-77.24491862136172,38.92906862347136],[-77.24491862136172,38.92906862347136]]]}
Dirigez-vous vers l’est	0,03108	0,300162	{"spatialReference":{"wkid":4326},"paths":[[[-77.24491862136172,38.92906862347136],[-77.24432026092327,38.92922419358836],[-77.2431644738714,38.92953551367221],[-77.24291516601454,38.92957141170151],[-77.24263625487299,38.92926048728733]]]}
Tournez à gauche, puis tournez à droite sur Leesburg Pike	0.422316089	1.215881348	{"spatialReference":{"wkid":4326},"paths":[[[-77.24263627476374,38.929260492606396],[-77.24232884852634,38.92937681604757], ...
Terminez à l’emplacement 2, à gauche	0	0	{"spatialReference":{"wkid":4326},"paths":[[[-80.78293244317324,35.10024066538108],[-80.78293244317324,35.10024066538108]]]}

FINDROUTEBYADDRESS

Il s’agit d’une fonction Routing (Calcul d’itinéraire). Recherchez la distance totale à parcourir (l’unité de mesure par défaut sont les miles) et le temps de trajet total (en minutes) entre deux adresses à l’aide du meilleur itinéraire trouvé.

Syntaxe

ARCGIS.FINDROUTEBYADDRESS(from_address, to_address, [travel_mode], [unit], [include_directions])

Paramètres

Paramètre	Description	Paramètre requis
from_address	Adresse du point de départ de l’itinéraire.	Oui
to_address	Adresse du point de destination de l’itinéraire.	Oui
travel_mode	Mode de déplacement de l’itinéraire. Au lieu d’une zone tampon en anneau, calculez une zone à l’aide d’un mode de déplacement. Par exemple, la marche, la conduite ou le camion. Par exemple, utilisez Distance à parcourir ou Temps de marche. Exécutez la fonction LISTTRAVELMODES pour demander une liste des modes de déplacement pris en charge. Si ce paramètre est laissé vierge, le mode de déplacement par défaut spécifié dans les paramètres de votre organisation ArcGIS est utilisé. Reportez-vous à la rubrique Configurer les modes de déplacement pour en savoir plus sur les modes de déplacement et les paramètres.	Non
unité	Unité de mesure de la distance à parcourir. Ce paramètre peut être exprimé en miles, kilomètres, mètres, pieds, yards ou miles nautiques. La valeur par défaut sont les miles.	Non
include_directions	Si ce paramètre est défini sur TRUE, la feuille de route vers la destination, ainsi que la durée du trajet et la distance parcourue à chaque étape sont incluses dans les résultats. La valeur par défaut est FALSE.	Non

Exemple de fonction 1

=ARCGIS.FINDROUTEBYADDRESS("380 New York Street Redlands CA", "Downtown Riverside")

Résultat

Distance parcourue (miles)	Durée du trajet (minutes)	Forme de l’itinéraire
14,32662	20,73435	{"spatialReference":{"latestWkid":4326,"wkid":4326},"paths":[[[-117.194789317,34.057516991],[-117.1940741,34.057515], ...

Exemple de fonction 2

=ARCGIS.FINDROUTEBYADDRESS("380 New York Street Redlands CA", "Downtown Riverside", "Driving Distance", "kilometers", TRUE)

Résultat

Description	Distance parcourue (kilomètres)	Durée du trajet (minutes)	Forme de l’itinéraire
Distance parcourue/durée du trajet au total	22,9899	22,40177
Démarrez à l’emplacement 1	0	0	{"spatialReference":{"wkid":4326},"paths":[[[-117.19478927505831,34.057516969635486],[-117.19478927505831,34.057516969635486]]]}
Dirigez-vous vers l’est	0.0660270315239986	0.396162189143992	{"spatialReference":{"wkid":4326},"paths":[[[-117.19478927505831,34.057516969635486],[-117.19407404027919,34.057515005004625]]]}
Tournez à gauche	0.0665435791015625	0.3992919921875	{"spatialReference":{"wkid":4326},"paths":[[[-117.19407405467044,34.057514980900905],[-117.19406685106797,34.05811489909636]]]}
Terminez à l’emplacement 2, à gauche	0	0	{"spatialReference":{"wkid":4326},"paths":[[[-117.37829693421398,33.97863201286705],[-117.37829693421398,33.97863201286705]]]}

VERTICESTOESRIJSON

Il s’agit d’une fonction Geometry (Géométrie). Crée une géométrie de polygone ou de polyligne EsriJSON à partir de la liste des coordonnées de ses sommets.

Syntaxe

ARCGIS.VERTICESTOESRIJSON (xy_vertices, spatial_reference, geometry_type, y_then_x)

Paramètres

Paramètre	Description	Paramètre requis
xy_vertices	Plage de cellules contenant les coordonnées des sommets. Les sommets peuvent être indiqués au format ligne ou colonne.	Oui
spatial_reference	Référence spatiale de la localisation du point. Il peut s’agir d’un WKID (nombre) ou d’un WKT (texte). Reportez-vous à la liste des valeurs de WKID valides. La valeur par défaut est 4326 (WGS84).	Non
geometry_type	Type de géométrie. Le paramètre peut prendre la valeur Polyline (Polyligne) ou Polygon (Polygone). La valeur par défaut est Polygon (Polygone).	Non
y_then_x	Si ce paramètre est défini sur TRUE (VRAI), cela signifie que les coordonnées indiquent la latitude (Y) en premier, puis la longitude (X). La valeur par défaut est FALSE (FAUX). L’ordre des coordonnées par défaut est X, suivi de Y.	Non

CONVERTTOESRIJSON

Il s’agit d’une fonction Geometry (Géométrie). Convertit une géométrie d’un format autre qu’Esri en géométrie EsriJSON.

Syntaxe

ARCGIS.CONVERTTOESRIJSON (geometry_to_convert)

Paramètres

Paramètre	Description	Paramètre requis
geometry_to_convert	Géométrie à convertir en EsriJSON. Il peut s’agir d’une géométrie WKT ou GeoJSON.	Oui

GETPOLYGONAREA

Il s’agit d’une fonction Geometry (Géométrie). Calcule la surface d’un polygone.

Syntaxe

ARCGIS.GETPOLYGONAREA(esrijson_polygon, unit, measurement_type)

Paramètres

Paramètre	Description	Paramètre requis
Esrijson_geometry	Géométrie JSON d’Esri.	Oui
Unité	Unité de mesure du paramètre distance. Il peut s’agir des millimètres carrés, des décimètres carrés, des mètres carrés, des kilomètres carrés, des pouces carrés, des pieds carrés, des yards carrés, des miles carrés, des pieds américains carrés, des acres ou des hectares. Si le paramètre travel_mode est défini, il peut également s’agir de secondes, minutes ou heures. La valeur par défaut est miles.	Oui
Measurement_type	Type de mesure utilisé pour déterminer la distance. Les valeurs de paramètre peuvent être : plane Géodésique Loxodromie Grande elliptique La valeur par défaut est Géodésique.	Oui

GETGEOMETRYLENGTH

Il s’agit d’une fonction Geometry (Géométrie). Calcule la longueur de la géométrie.

Syntaxe

=ARCGIS.GETGEOMETRYLENGTH(esrijson_geometry, unit, measurement_type)

Paramètres

Paramètre	Description	Paramètre requis
Esrijson_geometry	Géométrie JSON d’Esri.	Oui
Unité	Unité de mesure du paramètre distance. Il peut s’agir des centimètres, des décimètres, des mètres, des kilomètres, des pouces, des pieds, des yards, des miles, des pieds américains ou des milles nautiques. La valeur par défaut est miles.	Oui
Measurement_type	Type de mesure utilisé pour déterminer la distance. Les valeurs de paramètre peuvent être : plane Géodésique Loxodromie Grande elliptique La valeur par défaut est Géodésique.	Oui

GETGEOMETRYDISTANCE

Il s’agit d’une fonction Geometry (Géométrie). Calculer la distance entre deux géométries.

Syntaxe

=ARCGIS.GETGEOMETRYDISTANCE(esrijson_geometry1, esrijson_geometry2, unit, measurement_type)

Paramètres

Paramètre	Description	Paramètre requis
Esrijson_geometry1	Première géométrie JSON d’Esri.	Oui
Esrijson_geometry2	Deuxième géométrie JSON d’Esri.	Oui
Unité	Unité de mesure du paramètre distance. Il peut s’agir des centimètres, des décimètres, des mètres, des kilomètres, des pieds, des yards, des miles, des pieds américains ou des milles nautiques. La valeur par défaut est miles.	Oui
Measurement_type	Type de mesure utilisé pour déterminer la distance. Les valeurs de paramètre peuvent être : plane Géodésique Loxodromie Grande elliptique La valeur par défaut est Géodésique.	Oui

GETCENTROID

Il s’agit d’une fonction Geometry (Géométrie). Calcule le centroïde d’une géométrie.

Syntaxe

=ARCGIS.GETCENTROID(esrijson_geometry)

Paramètres

Paramètre	Description	Paramètre requis
Esrijson_geometry	Il s’agit d’une géométrie JSON d’Esri.	Oui

RELATEGEOMETRIES

Il s’agit d’une fonction Geometry (Géométrie). Compare deux géométries en exécutant une opération de relation spatiale.

Syntaxe

=ARCGIS.RELATEGEOMETRIES(esrijson_geometry_or_XY1, topologocal_operation, esrijson_geometry_or_XY2)

Paramètres

Nom	Description	Paramètre requis
esrijson_geometry_or_XY1	Première géométrie JSON d’Esri ou coordonnées du premier point à comparer.	Oui
topologocal_operation	Opérateur de relation spatiale topologique à utiliser pour comparer les géométries. Les valeurs possibles de ce paramètre sont : Contient Croise Est égal à Intersecte Touche Superpose	Oui
esrijson_geometry_or_XY2	Deuxième géométrie JSON d’Esri ou coordonnées du deuxième point à comparer.	Oui

GENERALIZEGEOMETRY

Il s’agit d’une fonction Geometry (Géométrie). Généralise une géométrie à l’aide de l’algorithme de Douglas-Peucker.

Syntaxe

=ArcGIS.GENERALIZEGEOMETRY(esrijson_geometry, max_deviation, max_deviation_unit, remove_degenerate_parts)

Paramètres

Paramètre	Description	Paramètre requis
Esrijson_geometry	Géométrie JSON d’Esri.	Oui
Max_deviation	Écart maximal autorisé entre la géométrie généralisée et la géométrie d’origine. Si la valeur du paramètre maxDeviation est égale ou inférieure à zéro, l’opérateur renvoie la géométrie en entrée.	Oui
Max_deviation_unit	Unité de longueur de l’écart maximal autorisé. Une erreur se produit si cette valeur est définie pour Systèmes de coordonnées géographiques. Lorsque la valeur n’est pas définie, l’unité de référence spatiale de la géométrie est utilisée.	Oui
Remove_degenerate_parts	Lorsque la valeur est TRUE, toutes les parties de la géométrie généralisée avec une dimensionnalité inférieure à l’entrée (un polygone généralisé en ligne, par exemple) sont supprimées de la sortie. La valeur par défaut est FALSE.	Oui

SUGGESTADDRESS

Il s’agit d’une fonction Helper (Assistance). Suggère les adresses en fonction d’une saisie textuelle. Peut servir comme recherche d’adresse interactive avec suggestions automatiques.

Syntaxe

ARCGIS.SUGGESTADDRESS(search_term, [max_suggestions], [country], [geocode_service])

Paramètres

Paramètre	Description	Paramètre requis
search_term	Texte en entrée fourni par un utilisateur, qui sert à générer une liste de correspondances possibles.	Oui
max_suggestions	Nombre maximal de suggestions à renvoyer. Si ce nombre est supérieur à 15, les suggestions sont effectuées par l’opération de géocodage, qui peut consommer des crédits supplémentaires et est susceptible de générer des résultats inattendus. La valeur par défaut est 5. La valeur maximale est 50.	Non
pays	Restreint les résultats à un pays en particulier. Par exemple, utilisez Royaume-Uni. Exécutez ARCGIS.LISTGEOGRAPHIES pour demander une liste des pays.	Non
geocode_service	Nombre maximal de suggestions à renvoyer. Si ce nombre est supérieur à 15, les suggestions sont effectuées par l’opération de géocodage, qui peut consommer davantage de crédits et est susceptible de générer des résultats différents. La valeur par défaut est 5. La valeur maximale est 50.	Non

Exemple de fonction

=ARCGIS.SUGGESTADDRESS("Orange county",10, "USA")

Résultat

Comté d’Orange, CA, États-Unis

Comté d’Orange, FL, États-Unis

Comté d’Orange, IN, États-Unis

Comté d’Orange, NC, États-Unis

Comté d’Orange, NY, États-Unis

Comté d’Orange, TX, États-Unis

Comté d’Orange, VA, États-Unis

Comté d’Orange, VT, États-Unis

Orange County Great Park, Irvine, CA, États-Unis

Orange County Airport, 500 Dunn Rd, Montgomery, NY, 12549, États-Unis

GETGEOMETRY

Il s’agit d’une fonction Helper (Assistance). Obtenez une géographie spécifique, notamment son ID de zone et sa géométrie.

Syntaxe

ARCGIS.GETGEOMETRY (country, geography_level_id, search_term, exact_match, show_all_matches)

Paramètres

Paramètre	Description	Paramètre requis
pays	Pays source des collections de données. Par exemple, utilisez les États-Unis. Exécutez la fonction LISTGEOGRAPHIES pour demander une liste des pays.	Oui
geography_level_id	ID du niveau géographique auquel l’ID de zone appartient. Exécutez la fonction LISTGEOGRAPHIES pour demander une liste des ID de zones disponibles pour un niveau géographique donné. Par exemple, "US.States" correspond aux États des États-Unis.	Oui
search_term	Nom de la géographie, utilisé comme terme de recherche. Par exemple, indiquez California, San Diego, CA.	Oui
exact_match	Ne renvoie que les résultats qui correspondent exactement au terme de recherche.	Non
show_all_matches	Renvoie tous les résultats qui correspondent au terme de recherche s’il correspond à plusieurs géographies	Non

LISTGEOGRAPHIES

Il s’agit d’une fonction Helper (Assistance). Selon les paramètres en entrée, une liste des pays, une liste des niveaux géographiques (par exemple, les districts ou provinces) d’un pays ou une liste des ID de zones d’un niveau géographique est renvoyée. La limite maximale pour les éléments de liste est de 5 000.

Syntaxe

ARCGIS.LISTGEOGRAPHIES([country], [geography_level_id], [search_term], [exact_match])

Paramètres

Paramètre	Description	Paramètre requis
pays	Pays source des collections de données. Par exemple, utilisez Royaume-Uni. Si une valeur est spécifiée, tous les niveaux géographiques de ce pays sont répertoriés. Si cette fonction n’est pas renseignée, tous les pays et territoires sont répertoriés	Non
geography_level_id	ID d’un niveau géographique. Par exemple, utilisez US.States pour les États des États-Unis. Si une valeur est spécifiée, toutes les zones d’un niveau géographique, comme Californie, ainsi que leurs ID FIPS, sont répertoriés. Si ce paramètre est laissé vierge, les résultats dépendent du paramètre country.	Non
search_term	Terme de recherche qui affine les résultats en appariant le terme de recherche avec les noms de géographies.	Non
exact_match	Ne renvoie que les résultats qui correspondent exactement au terme de recherche.	Non

Exemple de fonction

=ARCGIS.LISTGEOGRAPHIES()

Résultat

Pays	Code de pays
Albanie	AL
Algérie	DZ
Andorre	AD
Angola	AO
Anguilla	IA

=ARCGIS.LISTGEOGRAPHIES("USA")

Résultat

ID	Nom
US.WholeUSA	Tout le pays
US.States	États
US.DMA	Secteurs (District Metered Areas, DMA)
US.CD	Circonscriptions électorales du Congrès
US.CBSA	Zones statistiques principales
US.Counties	Comtés
US.CSD	Sous-divisions de comté
US.ZIP5	Codes postaux
US.Places	Villes et villages (Lieux)
US.Tracts	Secteurs de recensement
US.BlockGroups	Groupes d’îlots

=ARCGIS.LISTGEOGRAPHIES("Spain","ES.Municipalities")

Résultat

ID	Nom	Subdivision géographique principale
01001	Alegría-Dulantzi	Pays Basque
01002	Amurrio	Pays Basque
01003	Aramaio	Pays Basque
01004	Artziniega	Pays Basque
01006	Armiñón	Pays Basque

=ARCGIS.LISTGEOGRAPHIES("Spain","ES.Municipalities","Barcelona")

ID	Nom	Subdivision géographique principale
08019	Barcelone	Catalogne

LISTDATACOLLECTIONS

Il s’agit d’une fonction Helper (Assistance). Répertorie les collections de données disponibles pour un pays.

Syntaxe

ARCGIS.LISTDATACOLLECTIONS(country, [data_collection_id], [search_term])

Paramètres

Paramètre	Description	Paramètre requis
pays	Pays source des collections de données. Par exemple, utilisez Royaume-Uni. Exécutez la fonction LISTGEOGRAPHIES pour demander une liste des pays.	Oui
data_collection_id	ID d’une collection de données. Par exemple, utilisez KeyFacts. Si une valeur est spécifiée, toutes les variables de la collection de données sont répertoriées. Si cette fonction n’est pas renseignée, toutes les collections de données du pays spécifié sont répertoriées	Non
search_term	Terme de recherche qui affine les résultats en appariant le terme de recherche avec les noms et les descriptions des collections de données ou avec les noms et les descriptions des variables. Par exemple, utilisez fast food.	Non

Exemple de fonction

=ARCGIS.LISTDATACOLLECTIONS("USA")

Résultat

ID	Description	Exemple de données
1yearincrements	La collection de données 1 Year Increments (Incréments de 1 an) inclut la population totale par incréments d’un an jusqu’à l’âge de 84 ans pour 2023 et 2028. La collection inclut également la population en 2010 par incréments d’un an jusqu’à l’âge de 21 ans. Les tables de données incluent l’âge pour la population totale et l’âge par genre. Cette collection contient des données provenant de la base de données démographiques actualisées pour 2023/2028 de Esri et de la base de données du recensement de 2010 de Esri.	Population 2023 - Âge < 1 Population 2023 - Âge 10 Population 2023 - Âge 35
5yearincrements	La collection de données 5 Year Increments (Incréments de 5 ans) inclut la population totale par incréments de 5 ans pour 2023, 2028 et 2010. Les tables de données incluent l’âge pour la population totale et l’âge par genre. Cette collection contient des données provenant de la base de données démographiques actualisées pour 2023/2028 de Esri, de la base de données American Community Survey (ACS) et de la base de données du recensement de 2010.	Population 2023 - Âge 0 à 4 Population 2023 - Âge 25 à 29 Population 2023 - Âge 40 à 44
Age	Cette collection de données inclut les données de tranche d’âges pour les hommes et les femmes, qui sont utilisées pour l’infographie pyramidale. Cette collection contient des données provenant de la base de données démographiques actualisées pour 2023 de Esri.	2023 Hommes Âge 0 à 4 2023 Femmes Âge 5 à 9 2023 Hommes Âge 60 à 64

=ARCGIS.LISTDATACOLLECTIONS("USA","health")

Résultat

ID	Nom	Description
REL65HI2OC	2023 Pop 65+: Other Health Ins Combos REL (ACS 5-Yr) (Pop 65+ : Autres combi. d’assurances maladie REL (ACS 5 ans))	2023 Population 65+: Other Health Ins Combinations REL (ACS 5-Yr) (Pop 65+ : Autres combinaisons d’assurances maladie REL (ACS 5 ans))
ACSCIVNINS	2023 Civ Noninstitutionalized Population (ACS 5-Yr) (Population civ. non institutionnalisée (ACS 5 ans))	2023 Civilian Noninstitutionalized Population (ACS 5-Yr) (Population civile non institutionnalisée (ACS 5 ans))
MOECIVNINS	2023 Civ Noninstitutionalized Population MOE (ACS 5-Yr) (Marge d’erreur pour la population civ. non institutionnalisée (ACS 5 ans))	2023 Civilian Noninstitutionalized Population MOE (ACS 5-Yr) (Marge d’erreur pour la population civile non institutionnalisée (ACS 5 ans))

=ARCGIS.LISTDATACOLLECTIONS("USA", "health", "<19")

Résultat

ID	Nom	Description
ACSCIVNI0	2023 Civ Noninstitutionalized Pop <19 (ACS 5-Yr) (Pop civ. non institutionnalisée <19 (ACS 5 ans))	2023 Civilian Noninstitutionalized Pop <19 (ACS 5-Yr) (Pop civile non institutionnalisée <19 (ACS 5 ans))
ACS0ONEHI	2023 Pop <19: 1 Type of Health Ins (ACS 5-Yr) (Pop <19 : 1 type d’assurance maladie (ACS 5 ans))	2023 Population <19: One Type of Health Insurance (ACS 5-Yr) (Pop <19 : Un type d’assurance maladie (ACS 5 ans))
MOE0ONEHI	2023 Pop <19: 1 Type of Health Ins MOE (ACS 5-Yr) (Pop <19 : Marge d’erreur pour 1 type d’assurance maladie (ACS 5 ans))	2023 Population <19: One Type of Health Insurance MOE (ACS 5-Yr) (Pop <19 : Marge d’erreur pour un type d’assurance maladie (ACS 5 ans))

Remarque :

Dans tous les exemples de fonctions, le résultat réel des fonctions exclut l’en-tête. Exécutez la fonction ADDHEADERS pour demander les en-têtes.

LISTTRAVELMODES

Il s’agit d’une fonction Helper (Assistance). Répertorie tous les modes de déplacement du service d’itinéraire pris en charge par ArcGIS Online ou configurés pour votre organisation.

Remarque :

Cette fonction ne nécessite aucun paramètre. Pour obtenir un exemple similaire, consultez l’article Microsoft Fonction RAND.

Syntaxe

ARCGIS.LISTTRAVELMODES()

Exemple de fonction

=ARCGIS.LISTTRAVELMODES()

Nom	Description	Détails
Temps de trajet en voiture	Ce modèle de circulation est adapté aux voitures et aux autres petits gabarits, comme les camionnettes. Il calcule des itinéraires qui optimisent le temps du trajet. L’itinéraire proposé respecte les routes à sens unique, permet d’éviter les virages illégaux, et suit d’autres règles qui sont spécifiques aux voitures. Lorsque vous spécifiez une heure de début, les vitesses de déplacement temps réel basées sur le trafic sont utilisées si elles sont disponibles.	Éviter les routes de covoiturage ; Éviter les voies rapides ; Éviter les barrières ; Éviter les routes privées ; Éviter les routes non goudronnées ; Conduire une automobile ; Routes en construction interdites ; Trafic de passage interdit ; Vitesse maximale du véhicule (km/h) : Temps de trajet 0
Durée du trajet à pied	Ce modèle de circulation est adapté aux piétons. Il calcule des itinéraires qui optimisent le temps du trajet. La vitesse moyenne de déplacement est estimée à 5 km/h.	Éviter les routes privées ; Éviter les itinéraires non adaptés aux piétons ; Privilégié pour les piétons ; Vitesse de marche (km/h) : Temps de marche 5 ; Marche
Distance à pied	Ce modèle de circulation est adapté aux piétons. Il calcule des itinéraires qui optimisent la distance du trajet.	Éviter les routes privées ; Éviter les itinéraires non adaptés aux piétons ; Privilégié pour les piétons ; Vitesse de marche (km/h) : Temps de marche 5 ; Marche

Remarque :

Dans tous les exemples de fonctions, le résultat réel des fonctions exclut l’en-tête. Exécutez la fonction ADDHEADERS pour demander les en-têtes.

ADDHEADERS

Créez une ligne d’en-tête pour la sortie des fonctions ArcGIS for Excel. Cette fonction n’est pas applicable pour certaines fonctions, par exemple celles qui se trouvent sous la catégorie de fonctions Helper.

Remarque :

Cette fonction ne requiert qu’un seul paramètre.

Remarque :

Dans tous les exemples de fonctions, le résultat réel des fonctions exclut l’en-tête. Exécutez la fonction ADDHEADERS pour demander les en-têtes.

Syntaxe

ARCGIS.ADDHEADERS(ARCGIS_function)

Paramètres

Paramètre	Description	Paramètre requis
ARCGIS_function	Saisissez une référence de cellule dans une autre fonction ArcGIS for Excel où vous souhaitez ajouter des en-têtes.	Oui

Exemple de fonction

=ARCGIS.ADDHEADERS(A2)

Cet exemple fonctionne si vous avez une autre fonction dans la cellule A2. Par exemple, si la cellule A2 contient la fonction =ARCGIS.GETCOORDINATES("380 New York Street, Redlands, CA, USA").

Résultat

Longitude (X)

Latitude (Y)

Virgule, point et point-virgule comme séparateurs

Si vous utilisez un système d’exploitation allemand, hollandais, espagnol, français ou italien, les nombres écrits sous forme décimale peuvent avoir un format différent de celui utilisé par les systèmes d’exploitation anglais. Pour certaines langues, une virgule (,) peut être utilisée à la place d’un point (.) comme séparateur décimal.

Le format des fonctions Excel est différent selon le séparateur décimal.

• Lorsqu’un séparateur décimal sous forme de point (.) est utilisé, vous devez séparer les entrées de paramètre des fonctions à l’aide d’une virgule (,) (par exemple, =ARCGIS.GETADDRESS(-70.251, 43.65808)).
• Lorsqu’un séparateur décimal sous forme de virgule (,) est utilisé, vous devez séparer les entrées de paramètre des fonctions à l’aide d’un point-virgule (;) (par exemple, =ARCGIS.GETADDRESS(-70,251; 43,65808)).

Dans Excel, le séparateur décimal par défaut est celui de votre système d’exploitation. Si vous utilisez Excel, vous pouvez également personnaliser ce paramètre.