Endpoint OGC CSW

Diperbarui 3 Agustus 2026

Endpoint OGC CSW 2.0.2

Endpoint CSW memungkinkan integrasi dengan software GIS dan sistem katalog yang mendukung standar OGC Catalogue Service for the Web.

URL

GET  https://geokatalog.my.id/csw
POST https://geokatalog.my.id/csw

Endpoint ini publik — tidak memerlukan autentikasi.

Operasi yang Didukung

Operasi	Method	Keterangan
GetCapabilities	GET/POST	Deskripsi layanan + operasi yang tersedia
GetRecords	GET/POST	Cari metadata dengan filter
GetRecordById	GET/POST	Ambil metadata berdasarkan ID
DescribeRecord	GET/POST	Deskripsi schema record

GetCapabilities

GET /csw?SERVICE=CSW&VERSION=2.0.2&REQUEST=GetCapabilities

Mengembalikan XML berisi:

Identitas layanan (nama instansi, kontak, alamat, jam operasional)
Operasi yang tersedia
Filter capabilities
Output schemas yang didukung

GetRecords (GET)

GET /csw?SERVICE=CSW&VERSION=2.0.2&REQUEST=GetRecords
  &OUTPUTSCHEMA=http://www.isotc211.org/2005/gmd
  &MAXRECORDS=10
  &STARTPOSITION=1
  &q=peta+jalan
  &BBOX=105,-9,116,-5.8

Parameter GetRecords

Parameter	Default	Keterangan
OUTPUTSCHEMA	Dublin Core	Schema output: Dublin Core, GMD (`http://www.isotc211.org/2005/gmd`), atau ISO 19115-3
MAXRECORDS	100	Jumlah record per halaman (maks. 500)
STARTPOSITION	1	Posisi awal paginasi
RESULTTYPE	results	`results` (data), `hits` (hanya jumlah), `validate`
q / Q	—	Pencarian teks bebas
BBOX	—	Filter spasial: `minX,minY,maxX,maxY` (WGS84)
TYPENAMES	—	`gmd:MD_Metadata` untuk output GMD

GetRecords (POST/XML dengan OGC Filter)

<?xml version="1.0" encoding="UTF-8"?>
<csw:GetRecords xmlns:csw="http://www.opengis.net/cat/csw/2.0.2"
                xmlns:ogc="http://www.opengis.net/ogc"
                xmlns:gmd="http://www.isotc211.org/2005/gmd"
                service="CSW" version="2.0.2"
                outputSchema="http://www.isotc211.org/2005/gmd"
                maxRecords="10" startPosition="1">
  <csw:Query typeNames="gmd:MD_Metadata">
    <csw:Constraint version="1.1.0">
      <ogc:Filter>
        <ogc:And>
          <ogc:PropertyIsLike wildCard="%" singleChar="_" escapeChar="\">
            <ogc:PropertyName>AnyText</ogc:PropertyName>
            <ogc:Literal>%jalan%</ogc:Literal>
          </ogc:PropertyIsLike>
          <ogc:BBOX>
            <ogc:PropertyName>ows:BoundingBox</ogc:PropertyName>
            <gml:Envelope xmlns:gml="http://www.opengis.net/gml">
              <gml:lowerCorner>105 -9</gml:lowerCorner>
              <gml:upperCorner>116 -5</gml:upperCorner>
            </gml:Envelope>
          </ogc:BBOX>
        </ogc:And>
      </ogc:Filter>
    </csw:Constraint>
  </csw:Query>
</csw:GetRecords>

GetRecordById

GET /csw?SERVICE=CSW&VERSION=2.0.2&REQUEST=GetRecordById
  &ID=cm1abc123def,cm2xyz789ghi
  &OUTPUTSCHEMA=http://www.isotc211.org/2005/gmd

ID dipisahkan koma untuk multiple records.

Output Schema

Schema URI	Format	Keterangan
`http://www.opengis.net/cat/csw/2.0.2`	Dublin Core	Default, kompatibel paling luas
`http://www.isotc211.org/2005/gmd`	GMD ISO 19139	Full metadata geospasial
`http://standards.iso.org/iso/19115/-3/mdb/2.0`	ISO 19115-3	Standar terbaru

Caching CSW

Response CSW di-cache:

GetCapabilities: 10 menit
GetRecords: 60 detik (s-maxage=60)

Cache diinvalidasi otomatis setelah metadata baru terbit atau diubah statusnya.

Konfigurasi Identitas Layanan (GetCapabilities)

Identitas yang muncul di respons GetCapabilities dikonfigurasi di Admin → Pengaturan CSW:

Field	Xpath	Contoh
Judul Layanan	`ows:Title`	"Katalog Data Geospasial BIG"
Nama Instansi	`ows:ProviderName`	"BIG"
Abstrak	`ows:Abstract`	"Layanan katalog..."
Nama Kontak	`ows:IndividualName`	"Pusat Data & Informasi"
Jabatan	`ows:PositionName`	"Walidata"
Telepon	`ows:Voice`	"+62-21-xxxxx"
Email	`ows:ElectronicMailAddress`	"data@big.go.id"
Jam Operasional	`ows:HoursOfService`	"08:00-16:00 WIB"
Instruksi Kontak	`ows:ContactInstructions`	"Senin-Jumat"
Peran Kontak	`ows:Role`	"Walidata"

Provider Built-in: perubahan langsung berlaku. Provider pycsw: konfigurasi via variabel CSW_* di .env + docker compose restart pycsw.

Error Response

Error dikembalikan dalam format XML ExceptionReport OGC:

<?xml version="1.0" encoding="UTF-8"?>
<ows:ExceptionReport xmlns:ows="http://www.opengis.net/ows" version="1.2.0">
  <ows:Exception exceptionCode="InvalidParameterValue">
    <ows:ExceptionText>Unknown operation: GetRecordss</ows:ExceptionText>
  </ows:Exception>
</ows:ExceptionReport>

ExceptionCode	Keterangan
`MissingParameterValue`	Parameter wajib tidak ada
`InvalidParameterValue`	Nilai parameter tidak valid
`OperationNotSupported`	Operasi tidak didukung
`NoApplicableCode`	Error umum / internal

Integrasi GIS

QGIS (MetaSearch)

Menu Web → MetaSearch → Services → New
Nama: (bebas, mis. geoMDB-hub)
URL: https://geokatalog.my.id/csw
Klik Get Record Types → OK
Tab Search — cari dan tambahkan layer ke proyek

ArcGIS / ArcCatalog

ArcCatalog → GIS Servers → Add CSW Server
URL: https://geokatalog.my.id/csw
Klik Connect → telusuri dataset

GeoNetwork Harvesting

Admin → Harvesting → Add → pilih OGC CSW 2.0.2
URL: https://geokatalog.my.id/csw
Atur jadwal harvest dan output schema

Sebelumnya

Endpoint REST Publik

Selanjutnya

Endpoint Terautentikasi (Pilihan)

Dokumentasi