Bản đồ hành hương
Đọ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.
Dùng lang= với bất kỳ ngôn ngữ Pilgrimap đang hoạt động nào. Bản dịch còn thiếu sẽ dùng tiếng Anh.
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-dokumentation>; rel="describedby"GET https://pilgrimap.org/api/v1/meta?lang=viKế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/api/v1/placesq, category, country, region, locality, bbox, lat, lng, radius_km, fields, page, per_page
/api/v1/places/<slug>Complete localized place record
/api/v1/places/batch?slugs=…Up to 100 stable slugs in the requested order
/api/v1/search?q=…Place names, alternative names and localities; categories are not returned as suggestions
/api/v1/categoriesLocalized labels, icons, marker colours and place links
/api/v1/countriesCountry codes and published place totals
/api/v1/regions?country=DERegional facets and direct filter links
/api/v1/facetsCategory and country counts for interfaces
/api/v1/nearby?lat=…&lng=…Radius search with exact distance_km
/api/v1/places/<slug>/imagesImage URLs, thumbnails, dimensions and MIME types
/api/v1/places/<slug>/relatedCategory, region and distance based suggestions
/api/v1/geojsonAll filters supported; FeatureCollection
/api/v1/export?format=json|geojson|csvFiltered export with up to 10,000 records
/api/v1/map-providersSupported OSM-based map styles and attribution
/api/v1/openapi.jsonOpenAPI 3.1 machine-readable contract
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.
| 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 |
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.
const response = await fetch('https://pilgrimap.org/api/v1/places?country=DE&category=marienheiligtum&fields=id,slug,name,latitude,longitude&lang=vi');
const { data, pagination } = await response.json();import requests
response = requests.get(
'https://pilgrimap.org/api/v1/export',
params={'format': 'geojson', 'bbox': '8.0,47.0,14.0,51.0', 'lang': 'vi'},
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.