Δημόσιο και μόνο για ανάγνωση

API ανάγνωσης Pilgrimap

Διαβάστε δημοσιευμένους προσκυνηματικούς τόπους ως JSON, GeoJSON ή CSV και δημιουργήστε προσβάσιμα, παραμετροποιήσιμα iframe χωρίς κλειδί API.

Δημόσιο και μόνο για ανάγνωσηΔεν απαιτείται κλειδί APICORS enabled

Επισκόπηση

Χρησιμοποιήστε lang= με οποιαδήποτε ενεργή γλώσσα Pilgrimap. Οι ελλιπείς μεταφράσεις επιστρέφουν στα αγγλικά.

Διατηρήστε ορατή την αναφορά Pilgrimap.

Response headers:

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

JSON · GeoJSON · CSV · iFrame

Συνδυάστε φίλτρα κειμένου, κατηγορίας, χώρας, περιοχής, τοποθεσίας, ορίων χάρτη, ακτίνας, στοιχείων επικοινωνίας και ημερομηνίας. Χωρίστε πολλαπλές τιμές με κόμματα.

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

Τελικά σημεία

GET Places /api/v1/places

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

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

Complete localized place record

GET Batch lookup /api/v1/places/batch?slugs=…

Up to 100 stable slugs in the requested order

GET Search results /api/v1/search?q=…

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

GET Categories /api/v1/categories

Localized labels, icons, marker colours and place links

GET Countries /api/v1/countries

Country codes and published place totals

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

Regional facets and direct filter links

GET Facets /api/v1/facets

Category and country counts for interfaces

GET Nearby /api/v1/nearby?lat=…&lng=…

Radius search with exact distance_km

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

Image URLs, thumbnails, dimensions and MIME types

GET Related places /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 Map provider /api/v1/map-providers

Supported OSM-based map styles and attribution

GET OpenAPI /api/v1/openapi.json

OpenAPI 3.1 machine-readable contract

Φίλτρα

Συνδυάστε φίλτρα κειμένου, κατηγορίας, χώρας, περιοχής, τοποθεσίας, ορίων χάρτη, ακτίνας, στοιχείων επικοινωνίας και ημερομηνίας. Χωρίστε πολλαπλές τιμές με κόμματα.

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

Ρυθμίστε περιεχόμενο, πάροχο χάρτη, θέμα, χρώμα, καμπύλη γωνιών, κεφαλίδα και αναφορά.

Preview

Embed code

JavaScript

const response = await fetch('https://pilgrimap.org/api/v1/places?country=DE&category=marienheiligtum&fields=id,slug,name,latitude,longitude&lang=el');
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': 'el'},
    timeout=10,
)
response.raise_for_status()

The public read-only API provides published place and category data as JSON and GeoJSON. It is intended for church information services, research and responsible integrations.