# Guide API géographiques
{% hint style="danger" %}
[La Base Adresse Nationale est désormais portée par l'IGN](https://www.numerique.gouv.fr/espace-presse/la-base-adresse-nationale-ban-franchit-de-nouvelles-etapes-en-poursuivant-son-action-au-sein-de-lign/).
{% endhint %}
Ce guide propose d'explorer des cas pratiques d'utilisation des API géographiques mises à votre disposition pour vous accompagner dans leur utilisation, que vous soyez en train de construire une carte ou que vous souhaitiez récupérer des données géographiques.
Ce guide s'adresse donc à plusieurs types de profils :
* Néophytes dans l'utilisation des APIs ;
* Intégrateurs web ;
* Spécialistes du secteur géospatial.
Il s'agit d'un outil évolutif et ouvert. Vous pouvez contribuer à l'améliorer en proposant une modification sur [GitHub](https://github.com/etalab/guides.data.gouv.fr/tree/main/reutiliser-des-donnees/utiliser-les-api-geographiques) ou en [contactant directement](mailto:geo@data.gouv.fr) l'équipe Géo d'Etalab.
{% hint style="info" %}
**Quelles sont les API géographiques dont il est question dans ce guide ?**
* **API Adresse (Base Adresse Nationale - BAN)**
L'API Adresse permet d'interroger la Base Adresse Nationale, base de données de l’intégralité des adresses du territoire français.\
En intégrant l'API dans votre système d'information, vous pouvez facilement rechercher une adresse et notamment faire de l'autocomplétion et de la vérification d'adresse, géolocaliser une adresse sur une carte ou encore faire une recherche géographique inversée (trouver la rue la plus proche de coordonnées géographiques).
* **API Découpage administratif (API Geo)**
L'API Découpage Administratif permet d'interroger les référentiels géographiques plus facilement.\
En intégrant l'API dans votre système d'information, vous pouvez notamment rechercher une commune par nom, code postal ou coordonnées géographiques, rechercher un département par son nom ou encore rechercher une région par son nom.
* **Les tuiles vectorielles openmaptiles.geo.data.gouv.fr**
L'API permet de mettre à disposition des tuiles vectorielles qui sont affichables sur des cartes géographiques interactives.\
Elles servent principalement à afficher des fonds de plan mais aussi les contours cadastraux et les limites administratives en France.\
Cela permet de vous affranchir d'APIs cartographiques comme Google Maps.
{% endhint %}
{% hint style="success" %}
**Recommandations logiciels**
Il est recommandé d'avoir un navigateur web en ayant installé [l'extension JSONView](https://jsonview.com/) pour faciliter la compréhension des retours JSON.
Vous pouvez aussi installer un éditeur de texte plus agréable à utiliser que le Bloc-Notes/Notepad par défaut si vous êtes sous Windows. Il vous permettra en particulier lorsque vous faites des tests sur les URLs de les modifier avant de les copier dans la barre d'adresse de votre navigateur. Il peut s'agir de [Notepad++](https://notepad-plus-plus.org/downloads/) si vous êtes sous Windows ou bien de [Microsoft Visual Studio Code](https://code.visualstudio.com/) quel que soit votre système d'exploitation. Une liste plus complète d'éditeurs de texte est disponible [ici](https://fr.wikipedia.org/wiki/%C3%89diteur_de_texte#%C3%89diteurs_de_texte_couramment_utilis%C3%A9s).
{% endhint %}
Dans ce guide, vous apprendrez comment :
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://guides.data.gouv.fr/guides/reutiliser-des-donnees/utiliser-les-api-geographiques.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.