> 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/depannage/troubleshooting-your-arcgis-integrations.md).

# Dépannage de vos intégrations ArcGIS

L’intégration de couches ArcGIS dans Aphex permet aux équipes de construction de visualiser leurs calendriers par-dessus le plan réel du projet, des images ou des réseaux. Si vous rencontrez des problèmes lors de la configuration, cette page constitue un excellent point de départ : elle rassemble les problèmes les plus courants et leurs solutions.

## Conditions requises pour configurer un projet Aphex <a href="#h_52f4d84979" id="h_52f4d84979"></a>

Pour configurer une intégration ArcGIS, vérifiez que votre projet Aphex dispose des éléments suivants :

1. **Abonnement**: un abonnement actif à une formule Pro+ ou Enterprise (sauf si votre projet participe au programme bêta limité)
2. **Emplacement**: un emplacement Map Space créé depuis la page Locations d’Aphex Planner, et vous lancez l’intégration depuis cet emplacement Map Space.

## Problèmes et questions courants <a href="#h_8ae399230b" id="h_8ae399230b"></a>

Aphex permet de connecter des couches depuis n’importe quel service ArcGIS (Online ou Enterprise). Toutefois, si vous rencontrez des problèmes, voici quelques points courants à vérifier :

<figure><img src="https://2817901885-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FxZt0eqkHKfw04Wz0hBqC%2FArcGIS%20troubleshooting_%20%E2%80%9CWe%20couldn%E2%80%99t%20connect%20to%20this%20layer%E2%80%9D%20pop-up.svg?alt=media&amp;token=bcd02d2a-7572-470d-a5dc-643d317be818" alt=""><figcaption></figcaption></figure>

Si ArcGIS refuse le compte auquel vous tentez de vous connecter, Aphex affiche un message d’erreur qui en indique la raison.&#x20;

#### **Messages d’erreur de connexion**

<table><thead><tr><th width="226.03515625">Raison</th><th>Que faire</th></tr></thead><tbody><tr><td>L’authentification multifacteur (MFA) est activée</td><td>ArcGIS ne permet pas de se connecter avec un nom d’utilisateur et un mot de passe lorsque la MFA est activée, que vous l’ayez configurée vous-même ou que votre organisation l’exige. Connectez-vous plutôt à l’aide des identifiants d’une application (ID client et secret). Votre administrateur ArcGIS peut en créer pour vous.</td></tr><tr><td>ArcGIS n’a pas accepté ce nom d’utilisateur et ce mot de passe</td><td>Vérifiez le nom d’utilisateur et le mot de passe, puis réessayez. Si vous vous connectez à ArcGIS avec l’authentification unique (SSO), vous n’avez pas de mot de passe ArcGIS : utilisez plutôt les identifiants d’une application (ID client et secret).</td></tr><tr><td>ArcGIS a verrouillé ce compte</td><td>Trop de tentatives de connexion ont été effectuées avec un mot de passe incorrect. Attendez 15 minutes, puis mettez à jour le mot de passe à l’aide de <kbd>Modifier les identifiants</kbd></td></tr><tr><td>Votre organisation a désactivé ce compte</td><td>Demandez à votre administrateur ArcGIS de réactiver le compte ou connectez-vous avec un autre compte.</td></tr><tr><td>Ce compte n’appartient pas à l’organisation propriétaire de la couche</td><td>Connectez-vous avec un compte de l’organisation ArcGIS propriétaire de la couche, ou demandez à l’administrateur ArcGIS de cette organisation de vous ajouter.</td></tr><tr><td>ArcGIS n’a pas accepté cet ID client et ce secret</td><td>Ils ont peut-être été modifiés ou supprimés dans ArcGIS. Demandez les identifiants à jour à votre administrateur ArcGIS.</td></tr><tr><td>Cette couche se trouve sur un serveur ArcGIS Server</td><td>ArcGIS Server n’accepte pas les identifiants d’application. Connectez-vous plutôt à ce serveur avec un nom d’utilisateur et un mot de passe.</td></tr></tbody></table>

Voir aussi : <a href="https://help.aphex.co/docs/aphex-help-fr/integrations-et-api/couches-cartographiques-externes/arcgis-set-up-guide.md" class="button secondary">Connecter des couches ArcGIS</a>

### Accès aux couches <a href="#h_3440861823" id="h_3440861823"></a>

Pour connecter une couche ArcGIS à Aphex, vous devez fournir des identifiants valides lors de la configuration. Vérifiez que les identifiants fournis vous autorisent à consulter les couches à connecter.

{% hint style="info" %}
Si vous utilisez un compte Registered User pour accéder aux couches, vous pouvez vérifier son niveau d’accès en vous connectant à 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 est autorisé à la consulter.
{% endhint %}

### Couches prises en charge <a href="#h_e9781dda6c" id="h_e9781dda6c"></a>

Aphex prend actuellement en charge les ressources ArcGIS sources suivantes :

* Couches d’entités
* Couches d’images cartographiques
* Couches de tuiles (raster et vectorielles)
* Service de tuiles cartographiques Web (WMTS)

### Restrictions liées au partage de ressources entre origines (CORS) <a href="#h_a6c52905ec" id="h_a6c52905ec"></a>

Par défaut, ArcGIS autorise le CORS : les services externes tels qu’Aphex peuvent donc consulter des ressources comme les couches, à l’aide des identifiants appropriés. Toutefois, certains administrateurs SIG peuvent désactiver cette fonctionnalité pour renforcer la sécurité.

Si une couche se connecte correctement, mais qu’aucune donnée n’apparaît sur la carte, cela peut être dû à la politique CORS d’ArcGIS de votre entreprise.

ArcGIS permet d’activer le CORS, de le désactiver ou de le désactiver avec des exceptions. Vous pouvez donc demander à votre administrateur SIG de rétablir le paramètre par défaut (CORS activé) ou d’ajouter les domaines suivants aux exceptions CORS :

* `https://app.aphex.co`
* `https://dev.aphex.co`

{% hint style="warning" %}
Veillez à ajouter les domaines d’exception CORS exactement comme indiqué ci-dessus.
{% endhint %}

Pour savoir comment modifier la politique CORS d’ArcGIS, consultez 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).

### Problèmes de performances des couches

Aphex est conçu pour être aussi rapide et léger que possible, notamment pour les utilisateurs qui accèdent à leur projet avec une connexion médiocre ou un appareil peu puissant.

ArcGIS est toutefois 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 permet de la charger presque exactement de la même manière qu’à partir des services ESRI.

Pour réduire autant que possible les temps de chargement, chaque sous-couche d’une couche peut être masquée ou affichée selon le contexte nécessaire à ce moment-là.

Le nombre de sous-couches est actuellement limité à 42 par couche. Les sous-couches dont le chargement dépasse cette limite ne seront pas affichées.

{% hint style="info" %}
En général, une couche devrait se charger dans Aphex aussi rapidement que dans ArcGIS.\
\
Pour tester le temps de chargement auquel vos utilisateurs peuvent s’attendre, ouvrez d’abord la couche directement dans ArcGIS.
{% endhint %}

Par conséquent, les équipes qui créent des couches destinées à être utilisées dans Aphex doivent trouver un équilibre entre la quantité d’informations et les performances pour les utilisateurs finaux. Plus une couche contient de données, plus son chargement sera long pour tout le monde.

Voici quelques méthodes courantes pour optimiser les performances de chargement des couches dans ArcGIS et Aphex :

* **Type de couche**: les couches d’images tuilées ou raster se chargent généralement plus rapidement que les couches d’entités. C’est particulièrement vrai pour les couches contenant de nombreuses lignes, comme les tracés de conception. Dans la mesure du possible, privilégiez la publication de couches de ces types :
  * **Couches d’images cartographiques**: les conceptions, les réseaux et les tracés. Tout ce qui convient à une couche d’entités offrira de bonnes performances dans Aphex sous forme d’image cartographique.
  * **Couches de tuiles**: les images de drone ou autres images aériennes sont souvent déjà stockées sous forme de couches de tuiles et offrent de bonnes performances. Si le compte ESRI de votre entreprise ne prend pas en charge ce format, les images cartographiques conviendront également.
* **Sélection du serveur**: si votre entreprise peut publier des couches sur un serveur Enterprise ou ArcGIS Online, les performances sont généralement différentes entre les deux. Le serveur sur lequel les couches se chargent le plus vite dans le service ESRI sera également le plus rapide dans Aphex.


---

# 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/depannage/troubleshooting-your-arcgis-integrations.md?ask=<question>&goal=<user_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.
