Endpoint OGC CSW

Diperbarui 20 Juli 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://geospasial.pertanian.go.id/csw
POST https://geospasial.pertanian.go.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`	"[email protected]"
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://geospasial.pertanian.go.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://geospasial.pertanian.go.id/csw
Klik Connect → telusuri dataset

GeoNetwork Harvesting

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

Sebelumnya

Endpoint REST Publik

Selanjutnya

Endpoint Terautentikasi (Pilihan)

Dokumentasi