O tym API
Base Adresse Nationale (BAN) to referencyjny, państwowy zbiór adresów Francji. Usługa geokodowania Géoplateforme udostępnia go przez proste API REST: dla zapytania tekstowego (adres, nazwa miejscowości, działka katastralna) zwraca dopasowane obiekty ze współrzędnymi, znormalizowaną etykietą adresu oraz wskaźnikiem trafności (score). Odpowiedź ma format GeoJSON (FeatureCollection), więc trafia bez konwersji do bibliotek mapowych i systemów GIS. Wywołania pojedyncze idą metodą GET; dostępne jest też geokodowanie masowe plików metodą POST oraz geokodowanie odwrotne (współrzędne → adres). Indeks jest aktualizowany co tydzień z danych BAN. Usługę prowadzi IGN w ramach platformy Géoplateforme, a dane są objęte Licencją Otwartą Etalab 2.0.
Najczęstsze pytania
Czy trzeba mieć klucz API?
Nie. API jest w pełni otwarte — nie wymaga klucza, rejestracji ani uwierzytelniania. Wystarczy zwykłe zapytanie HTTP GET do punktu /geocodage/search.
Jakie dane zwraca to API?
Dla podanego adresu (lub nazwy miejscowości czy działki katastralnej) zwraca dopasowane obiekty w formacie GeoJSON: współrzędne geograficzne (WGS84), znormalizowaną etykietę adresu, kod i nazwę gminy, kod pocztowy oraz wskaźnik trafności dopasowania (score). Dane pochodzą z Base Adresse Nationale — referencyjnego rejestru adresów Francji.
Czy można wywołać to API bezpośrednio z przeglądarki?
Tak. Usługa zwraca otwarty nagłówek CORS (Access-Control-Allow-Origin: *), więc działa bezpośrednio z kodu front-endowego w przeglądarce — dlatego na tej stronie znajdziesz działający przycisk „Wypróbuj”.
Kto prowadzi to API?
Usługę prowadzi IGN (Institut national de l'information géographique et forestière — francuski krajowy instytut informacji geograficznej i leśnej) w ramach platformy Géoplateforme. Dane Base Adresse Nationale są udostępniane na Licencji Otwartej Etalab 2.0.