공개 및 읽기 전용

Pilgrimap 읽기 API

게시된 순례지를 JSON, GeoJSON 또는 CSV로 읽고 API 키 없이 설정 가능하고 접근성 높은 iframe을 만들 수 있습니다.

공개 및 읽기 전용API 키가 필요하지 않습니다CORS enabled

개요

lang=에 활성화된 Pilgrimap 언어를 사용할 수 있습니다. 번역이 없으면 영어로 대체됩니다.

Pilgrimap 출처 표시를 유지해 주세요.

Response headers:

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

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

필터

텍스트, 분류, 국가, 지역, 도시, 지도 범위, 반경, 연락처 및 날짜 필터를 조합할 수 있습니다. 여러 값은 쉼표로 구분합니다.

Parameter	Values	Purpose
`q`	text	Name, alternative name, locality, region, postal code
`category`, `categories`	comma-separated slugs	One or many categories; `exclude_category` excludes values
`country`, `countries`	ISO 3166-1 alpha-2	One or many countries
`region`, `locality`	one or many values	Geographic text filters
`bbox`	west,south,east,north	Map viewport, including antimeridian boxes
`lat`, `lng`, `radius_km`	coordinates + 1–1000 km	Geographic radius filter
`featured`, `has_images`, `has_website`, `has_phone`, `has_email`	true / false	Availability filters
`updated_since`	ISO-8601	Incremental synchronization
`fields`	comma-separated field names	Sparse fieldsets; id and slug remain present
`sort`, `order`	name/locality/updated · asc/desc	Stable ordering
`lang`	en, 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, tl	Localized 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=ko');
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': 'ko'},
    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.