Pilgrimap API

Đọc các địa điểm hành hương đã xuất bản dưới dạng JSON, GeoJSON hoặc CSV và tạo iframe có thể cấu hình, dễ tiếp cận mà không cần khóa API.

Developer API

Versionierte, öffentliche Lese-API für Orte, Kategorien, Länder, Regionen, Lexikon, Bilder, Exporte und Einbettungen.

Hãy giữ phần ghi nguồn Pilgrimap hiển thị.

Response headers:

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

JSON · GeoJSON · CSV · iFrame

Kết hợp bộ lọc văn bản, danh mục, quốc gia, vùng, địa phương, khung bản đồ, bán kính, thông tin liên hệ và ngày. Phân tách nhiều giá trị bằng dấu phẩy.

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

Điểm cuối

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

Kategorien mit Symbolen, Farben und Zählwerten

GET Category detail /api/v1/categories/<slug>

Kategorie mit Beschreibung und direkter Orts-Collection

GET Countries /api/v1/countries

Länderliste mit veröffentlichten Ortszahlen

GET Country detail /api/v1/countries/<code>

Landprofil mit Beschreibung und Orts-Collection

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

Regionen und direkte Filterlinks

GET Region detail /api/v1/regions/<code>/<region>

Regionsprofil mit Beschreibung und Orts-Collection

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

Bild-URLs, Thumbnails, Abmessungen und MIME-Typen

GET Single image /api/v1/images/<id>

Metadaten eines einzelnen veröffentlichten Ortsbildes

GET Lexicon /api/v1/lexicon

Alphabetisch durchsuchbare Lexikonartikel

GET Lexicon article /api/v1/lexicon/<slug>

Vollständiger Lexikonartikel als strukturierte Daten

GET Embeds /api/v1/embeds

Discovery-Endpunkt für verfügbare iFrame-Oberflächen

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

Licensed Eble IT MapLibre style contract

GET OpenAPI /api/v1/openapi.json

OpenAPI 3.1 machine-readable contract

Bộ lọc

Kết hợp bộ lọc văn bản, danh mục, quốc gia, vùng, địa phương, khung bản đồ, bán kính, thông tin liên hệ và ngày. Phân tách nhiều giá trị bằng dấu phẩy.

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

Trình tạo iframe

Cấu hình nội dung, nhà cung cấp bản đồ, chủ đề, màu sắc, bo góc, tiêu đề và ghi nguồn.

Preview

Embed code

JavaScript

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