> 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 plannings par-dessus la conception réelle du projet, les images ou les services. Si vous rencontrez des problèmes lors de la configuration, voici un point de départ très utile qui rassemble les problèmes et les solutions les plus courants.

## Exigences de configuration du projet Aphex <a href="#h_52f4d84979" id="h_52f4d84979"></a>

Pour configurer une intégration ArcGIS, assurez-vous que votre projet Aphex dispose des éléments suivants ;

1. **Abonnement**: Un abonnement actif aux formules Pro+ ou Enterprise est en place (sauf si votre projet participe au programme de bêta limitée)
2. **Emplacement**: Un emplacement Map Space est créé depuis la page Emplacements dans Aphex Planner, et vous lancez l’intégration depuis cet emplacement Map Space.

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

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 ;

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

La connexion d’une couche ArcGIS à Aphex nécessite de fournir des identifiants valides lors de la configuration. Veuillez vous assurer que les identifiants fournis disposent des autorisations nécessaires pour consulter les couches connectées.

{% 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 %}

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

Aphex prend actuellement en charge les ressources sources ArcGIS suivantes ;

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

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

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`

{% hint style="warning" %}
Veuillez vous assurer d’ajouter les domaines d’exception CORS exactement tels qu’ils apparaissent ci-dessus.&#x20;
{% endhint %}

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

### Problèmes de performance 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.

{% 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 %}

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.

Certaines tactiques courantes peuvent être utilisées pour maximiser les performances de chargement des couches dans ArcGIS comme dans Aphex ;

* **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 ;
  * **Couches d’images de carte**: Conceptions, réseaux, alignements. Tout ce qui convient à une couche d’entités fonctionnera bien dans Aphex en tant qu’image de carte.
  * **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 le prend pas en charge, l’image de carte fonctionnera également.
* **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.


---

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