Öffentlich und nur lesend

Pilgrimap-Lese-API

Veröffentlichte Wallfahrtsorte als JSON, GeoJSON oder CSV auslesen und ohne API-Schlüssel konfigurierbare, barrierearme iFrames erstellen.

Öffentlich und nur lesendKein API-Schlüssel erforderlichCORS aktiviert

Übersicht

Mit lang= kann jeder aktive Pilgrimap-Sprachcode verwendet werden. Fehlende übersetzte Felder fallen auf Englisch zurück.

Bitte die sichtbare Pilgrimap-Quellenangabe beibehalten.

Antwort-Header:

X-Pilgrimap-Attribution: Pilgrimap by Eble ITLink: <https://pilgrimap.org/de/api-dokumentation>; rel="describedby"GET https://pilgrimap.org/api/v1/meta?lang=de

JSON · GeoJSON · CSV · iFrame

Text, Kategorie, Land, Region, Ort, Kartenausschnitt, Radius, Kontaktdaten und Änderungsdatum lassen sich kombinieren. Mehrere Werte werden durch Kommas getrennt.

/api/v1/export?format=geojson&country=DE&category=marienheiligtum

Endpunkte

GET Orte /api/v1/places

q, category, country, region, locality, bbox, lat, lng, radius_km, fields, page, per_page

GET Orte /api/v1/places/<slug>

Complete localized place record

GET Mehrfachabruf /api/v1/places/batch?slugs=…

Up to 100 stable slugs in the requested order

GET Suchergebnisse /api/v1/search?q=…

Place names, alternative names and localities; categories are not returned as suggestions

GET Kategorien /api/v1/categories

Localized labels, icons, marker colours and place links

GET Länder /api/v1/countries

Country codes and published place totals

GET Regionen /api/v1/regions?country=DE

Regional facets and direct filter links

GET Facetten /api/v1/facets

Category and country counts for interfaces

GET Im Umkreis /api/v1/nearby?lat=…&lng=…

Radius search with exact distance_km

GET Bilder /api/v1/places/<slug>/images

Image URLs, thumbnails, dimensions and MIME types

GET Ähnliche Orte /api/v1/places/<slug>/related

Category, region and distance based suggestions

GET GeoJSON /api/v1/geojson

All filters supported; FeatureCollection

GET Export /api/v1/export?format=json|geojson|csv

Filtered export with up to 10,000 records

GET Kartenanbieter /api/v1/map-providers

Supported OSM-based map styles and attribution

GET OpenAPI /api/v1/openapi.json

OpenAPI 3.1 machine-readable contract

Filter

Text, Kategorie, Land, Region, Ort, Kartenausschnitt, Radius, Kontaktdaten und Änderungsdatum lassen sich kombinieren. Mehrere Werte werden durch Kommas getrennt.

ParameterValuesPurpose
qtextName, alternative name, locality, region, postal code
category, categoriescomma-separated slugsOne or many categories; exclude_category excludes values
country, countriesISO 3166-1 alpha-2One or many countries
region, localityone or many valuesGeographic text filters
bboxwest,south,east,northMap viewport, including antimeridian boxes
lat, lng, radius_kmcoordinates + 1–1000 kmGeographic radius filter
featured, has_images, has_website, has_phone, has_emailtrue / falseAvailability filters
updated_sinceISO-8601Incremental synchronization
fieldscomma-separated field namesSparse fieldsets; id and slug remain present
sort, ordername/locality/updated · asc/descStable ordering
langen, de, fr, it, es, pt, pl, ru, uk, nl, cs, sk, hu, ro, zh, ja, ko, ar, hi, tr, id, vi, el, hr, sl, sv, sw, tlLocalized content and fallbacks

iFrame-Konfigurator

Inhalt, Kartenanbieter, Farbstil, Akzentfarbe, Rundung, Kopfbereich und Quellenangabe konfigurieren. Die erzeugte URL aktualisiert sich sofort.

Vorschau

Einbettungscode

JavaScript

const response = await fetch('https://pilgrimap.org/api/v1/places?country=DE&category=marienheiligtum&fields=id,slug,name,latitude,longitude&lang=de');
const { data, pagination } = await response.json();

Python

import requests

response = requests.get(
    'https://pilgrimap.org/api/v1/export',
    params={'format': 'geojson', 'bbox': '8.0,47.0,14.0,51.0', 'lang': 'de'},
    timeout=10,
)
response.raise_for_status()

Die offene Leseschnittstelle macht veröffentlichte Orts- und Kategoriedaten maschinenlesbar. Sie eignet sich für eigene Karten, kirchliche Informationsangebote, Forschung und nichtkommerzielle Projekte. Schreibzugriffe, Benutzerkonten und interne Verwaltungsdaten sind nicht Bestandteil der API.