> For the complete documentation index, see [llms.txt](https://help.aphex.co/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.aphex.co/docs/aphex-help-fr/integrations-et-api/couches-cartographiques-externes/arcgis-set-up-guide.md). # Connecter les couches ArcGIS {% hint style="info" %} **À savoir avant de commencer :** * Cette fonctionnalité est disponible avec les formules Pro+ ou Enterprise * Vous devez être administrateur du projet pour configurer l'intégration * Aphex prend en charge la connexion de couches provenant de tout service ArcGIS (Online ou Enterprise) {% endhint %} Si votre équipe utilise ArcGIS pour gérer le contexte de conception, les réseaux, les zones d’exclusion ou les images aériennes, vous pouvez intégrer ces mêmes données dans Aphex. L’intégration ArcGIS vous permet de superposer des couches SIG en direct directement sur votre carte, afin que la planification à court terme se fasse avec le contexte réel du site sous les yeux. Ce guide vous explique comment connecter votre compte ArcGIS, trouver l’URL correcte de votre couche, l’ajouter à votre projet dans Aphex et gérer l’intégration par la suite. ## Types de couches ArcGIS pris en charge *** Aphex prend en charge une gamme de types de couches ArcGIS couramment utilisés. Voici ce que vous pouvez connecter et afficher dans votre projet. Nous mettrons cette liste à jour au fur et à mesure que d’autres seront ajoutés : `Couches d’entités` `Couches d’images de carte` `Couches de tuiles` (`Raster` et `Vecteur`)
Maximiser les performances de chargement des couches **Type de couche**: Les types de couches d’images en tuiles ou raster se chargent généralement plus vite que les couches d’entités. Cela est particulièrement vrai pour les couches comportant de nombreuses lignes, telles que les alignements de conception. Dans la mesure du possible, cherchez à publier des couches avec ces types ; | Type de couche | Meilleure utilisation | | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Couches d’images de carte | Conceptions, réseaux, alignements. Tout ce qui convient à une couche d’entités fonctionnera bien dans Aphex sous forme d’image cartographique. | | Utilisateurs de tuiles | Les images de drone ou autres images aériennes sont souvent déjà stockées sous forme de couches tuilées et fonctionnent bien. Si le compte ESRI de votre entreprise ne prend pas cela en charge, l’image cartographique fonctionnera aussi. | **Sélection du serveur**: Si votre entreprise peut publier des couches sur un serveur Enterprise ou ArcGIS Online, il existe généralement une différence de performance entre eux. Celui qui charge les couches le plus rapidement dans le service ESRI sera le plus rapide dans Aphex.
## Récupération de l’URL de la couche *** Pour connecter une couche à Aphex, vous aurez besoin de l’URL de la page depuis la page Détails de l’élément ArcGIS. Cela garantit que les métadonnées de la couche et les autorisations d’accès se chargent correctement.
#### Pour trouver l’URL de la couche : * Connectez-vous à votre instance ArcGIS * Accédez à la couche que vous souhaitez connecter à votre projet Aphex * Assurez-vous que la couche fait partie des types de couches pris en charge * Cliquez sur la couche pour ouvrir la `page Détails de l’élément` * Copiez l’URL depuis la barre d’adresse de votre navigateur - c’est l’URL que vous utiliserez dans Aphex L’URL des détails de l’élément ArcGIS se présente généralement dans un format similaire à celui ci-dessous ; ``` https://.maps.arcgis.com/home/item.html?id= ``` ## Connectez votre compte ArcGIS à Aphex *** Vous pouvez connecter votre compte ArcGIS à Aphex en utilisant soit vos identifiants de connexion ArcGIS, soit une [application enregistrée](https://developers.arcgis.com/documentation/security-and-authentication/app-authentication/tutorials/create-oauth-credentials-app-auth/). Une fois lié, vous pourrez accéder aux couches associées à votre compte ArcGIS connecté et les valider.
#### Pour ajouter vos identifiants ArcGIS dans Aphex : * Ouvrez votre projet Aphex * Cliquez sur le titre de votre projet en haut à gauche, puis sélectionnez `Intégrations` * Faites défiler jusqu’à la `Connexion cartographique` section * Cliquez sur et choisissez parmi : * `Utilisateur enregistré` * `Application enregistrée` (ID client et secret client - OAuth2) * Sélectionner
Utilisateur enregistré vs application enregistrée Vous pouvez connecter des couches ArcGIS privées à Aphex à l’aide soit d’un compte utilisateur enregistré, soit d’une application enregistrée (OAuth2.0). Les deux options fonctionnent, mais la connexion par application est plus flexible si vous gérez l’accès sur plusieurs projets. L’utilisation d’une **application enregistrée** permet de contrôler précisément quelles couches les projets peuvent consulter, sans dépendre d’un seul utilisateur ayant accès à tout. C’est particulièrement utile si votre organisation doit gérer les autorisations par projet ou restreindre l’accès à des couches sensibles. Avec un **utilisateur enregistré**, ce compte utilisateur doit avoir accès à chaque couche connectée — ce qui peut vite devenir complexe entre équipes ou projets. Les applications facilitent une montée en charge sécurisée.
## Ajouter des couches à la carte *** Une fois que vous avez l’URL de votre couche à portée de main, vous pouvez l’insérer dans n’importe quel emplacement réel de votre projet.\ Après la connexion, définissez une politique de couche pour contrôler précisément quelles sous-couches apparaissent dans Aphex, afin de garder les choses claires et pertinentes pour votre équipe. Aphex récupérera ensuite automatiquement toutes les mises à jour d’ArcGIS, afin que votre carte reste à jour sans que vous ayez besoin de tout recharger ou réimporter.
Les sources de couches privées et publiques de [ESRI ArcGIS](https://www.esri.com/en-us/home) peuvent être utilisées comme support de cartographie dans Aphex. Chaque emplacement Aphex peut accepter jusqu’à 20 connexions de couches différentes. Consultez notre Ajouter des couches cartographiques la doc pour obtenir des instructions étape par étape sur la manière d’ajouter des couches à la carte et de définir une politique de couche. ## Erreurs de connexion courantes *** Aphex prend en charge la connexion de couches depuis n’importe quel service ArcGIS (Online ou Enterprise) ; toutefois, certains points courants doivent être vérifiés si vous rencontrez des problèmes ; ### Les identifiants n’ont pas accès à la couche Vérifiez que l’utilisateur ou l’application ArcGIS que vous utilisez a l’autorisation de consulter la couche.\ Essayez de vous connecter directement à ArcGIS et d’ouvrir la couche avec les mêmes identifiants — si cela fonctionne là-bas, cela devrait fonctionner dans Aphex. {% hint style="info" %} Si vous utilisez un compte d’utilisateur enregistré pour l’accès, vous pouvez tester le niveau d’accès de ce compte en vous connectant simplement à votre compte ESRI/ArcGIS et en essayant d’ouvrir la couche que vous souhaitez intégrer.\ \ Si vous pouvez ouvrir une couche dans ArcGIS, votre compte a l’autorisation de la consulter. {% endhint %}
Exemples d’erreurs "*Échec de la connexion à votre instance ArcGIS* *Veuillez vérifier vos identifiants de connexion et réessayer, ou contacter votre administrateur ArcGIS*"
### Restrictions de partage de ressources entre origines (CORS) Par défaut, ArcGIS autorise CORS, ce qui signifie que des services externes comme Aphex peuvent, avec les identifiants appropriés, consulter des ressources telles que des couches. Cependant, certains administrateurs SIG peuvent désactiver cette fonctionnalité comme mesure de sécurité supplémentaire. Si vous constatez qu’une couche se connecte correctement, mais qu’aucune donnée n’est visible sur la carte, cela peut être dû à la politique CORS ArcGIS de votre entreprise. ArcGIS prend en charge un accès CORS activé, désactivé ou désactivé avec exceptions. Vous pouvez donc soit demander à votre administrateur SIG de rétablir la politique CORS sur l’état activé par défaut, soit d’ajouter les domaines suivants comme exceptions CORS ; * `https://app.aphex.co` * `https://dev.aphex.co` Pour des guides sur l’ajustement de la politique CORS ArcGIS, veuillez consulter le guide d’aide ArcGIS [ici](https://enterprise.arcgis.com/en/portal/latest/administer/windows/restrict-cross-domain-requests-to-your-portal.htm#:~:text=By%20default%2C%20an%20ArcGIS%20Enterprise,connect%20to%20your%20portal's%20resources).
Exemples d’erreurs **Erreur dans la fenêtre Ajouter une couche :** "*Erreur d’URL - Veuillez vérifier que l’URL est correcte et que le serveur est configuré pour autoriser les requêtes provenant de app.aphex.co*" **Erreur dans la console de développement du navigateur :** `L’accès à '' depuis l’origine 'https://app.aphex.co' a été bloqué par la politique CORS : aucun en-tête 'Access-Control-Allow-Origin' n’est présent sur la ressource demandée.`
### Type de couche non pris en charge ou URL invalide Assurez-vous d’utiliser la **l’URL de la page Détails de l’élément** (et non l’URL directe de la tuile ou le point de terminaison REST).\ Seuls les types de couches pris en charge (listés ci-dessus) se chargeront.
Exemples d’erreurs "*Erreur d’URL - Veuillez vérifier que l’URL est correcte et que le serveur est configuré pour autoriser les requêtes provenant de app.aphex.co*"
## Conseils pour les performances des couches *** Aphex est conçu pour être aussi rapide et léger que possible pour les utilisateurs susceptibles d’accéder à leur projet via des connexions faibles ou des appareils peu puissants. ArcGIS, en revanche, est un puissant service SIG qui permet à ses clients de créer d’immenses jeux de données géographiques. La connexion d’une couche ArcGIS à Aphex permettra de charger cette couche de manière presque identique à la façon dont elle est chargée depuis les services ESRI. Pour réduire au maximum les temps de chargement, chaque sous-couche d’une couche peut être réglée sur Masquer ou Afficher, selon le contexte requis à ce moment-là. Il existe actuellement une limite de 42 sous-couches par couche - toute sous-couche tentant de se charger au-delà de cette limite ne s’affichera pas. Par conséquent, les équipes qui créent des couches à utiliser dans Aphex doivent chercher à équilibrer les informations et les performances pour l’utilisateur final. Plus une couche contient de données, plus son chargement prendra de temps pour tout le monde. {% hint style="info" %} En général, Aphex devrait mettre autant de temps à charger une couche qu’ArcGIS pour charger la même couche.\ \ Vous pouvez tester le temps de chargement attendu pour vos utilisateurs en ouvrant d’abord une couche nativement dans ArcGIS. {% endhint %} ## Réduire les requêtes serveur (mode faible consommation de données) *** Pour les couches de service cartographique ArcGIS (couches tuilées raster et couches d’image cartographique), vous pouvez modifier le mode de requête, une fois la couche connectée à votre emplacement Aphex, afin de réduire les requêtes serveur.
#### Pour passer en mode faible consommation de données : * Ouvrez votre projet Aphex * Cliquez sur le titre de votre projet en haut à gauche, puis sélectionnez `Emplacements` * Repérez votre couche et cliquez sur `...` * Sélectionner `Afficher le résumé` puis faites défiler jusqu’à la section Réduire les requêtes serveur. Faites un choix entre : * `Optimisé` (par défaut) * `Réduire les requêtes serveur` * Cliquez sur Ce mode est défini couche par couche. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://help.aphex.co/docs/aphex-help-fr/integrations-et-api/couches-cartographiques-externes/arcgis-set-up-guide.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.