Dokumentasi integrasi

Integrasi Map Service RTRW Kaltim ke aplikasi WebGIS

Panduan teknis untuk menampilkan layanan Pola Ruang dan Struktur Ruang dari ArcGIS Enterprise Portal SIMTARU Kalimantan Timur menggunakan ArcGIS JavaScript API, OpenLayers, atau Leaflet.

Lihat implementasi SIMTARU

Endpoint layanan

Map Service ArcGIS Enterprise

Layanan berikut menggunakan endpoint ArcGIS REST MapServer. Gunakan endpoint layanan sesuai kebutuhan aplikasi dan sublayer yang tersedia pada service tersebut.

Pola Ruang Kaltim 2023

Layanan peruntukan dan arahan Pola Ruang RTRW Provinsi Kalimantan Timur.

https://portal-simtaru.kaltimprov.go.id/server/rest/services/POLA_RUANG_KALTIM_2023/MapServer

Struktur Ruang

Layanan sistem jaringan dan struktur ruang Provinsi Kalimantan Timur.

https://portal-simtaru.kaltimprov.go.id/server/rest/services/Struktur_Ruang/STRUKTUR_RUANG/MapServer

Untuk mengakses feature tertentu, tambahkan nomor sublayer di akhir URL, misalnya /MapServer/12. Periksa direktori REST service untuk daftar sublayer, field, renderer, extent, dan kemampuan query yang tersedia.

1. ArcGIS JavaScript API

Pilihan utama bila aplikasi membutuhkan renderer, popup, query spasial, legend, atau widget ArcGIS secara native. Gunakan MapImageLayer untuk menampilkan keseluruhan Map Service; gunakan FeatureLayer pada URL sublayer ketika membutuhkan query feature.

JavaScript MapImageLayer + FeatureLayer

import Map from "@arcgis/core/Map.js";
import MapView from "@arcgis/core/views/MapView.js";
import MapImageLayer from "@arcgis/core/layers/MapImageLayer.js";
import FeatureLayer from "@arcgis/core/layers/FeatureLayer.js";

const polaRuang = new MapImageLayer({
  url: "https://portal-simtaru.kaltimprov.go.id/server/rest/services/POLA_RUANG_KALTIM_2023/MapServer",
  title: "Pola Ruang Kaltim 2023", opacity: 0.75
});

// Contoh sublayer Struktur Ruang: Sistem Jaringan Transportasi
const transportasi = new FeatureLayer({
  url: "https://portal-simtaru.kaltimprov.go.id/server/rest/services/Struktur_Ruang_Aall/STRUKTUR_RUANG_ALL/MapServer/12",
  outFields: ["*"], title: "Sistem Jaringan Transportasi"
});

const map = new Map({ basemap: "streets-navigation-vector", layers: [polaRuang, transportasi] });
const view = new MapView({ container: "map", map, center: [116.5, 0.5], zoom: 7 });

2. OpenLayers

Untuk OpenLayers, gunakan TileArcGISRest agar Map Service dirender sebagai tile dari ArcGIS REST. Metode ini cocok untuk overlay visual service tanpa perlu mengunduh seluruh feature ke browser.

JavaScript OpenLayers TileArcGISRest

import Map from "ol/Map.js";
import View from "ol/View.js";
import TileLayer from "ol/layer/Tile.js";
import TileArcGISRest from "ol/source/TileArcGISRest.js";
import OSM from "ol/source/OSM.js";

const polaRuang = new TileLayer({
  opacity: 0.72,
  source: new TileArcGISRest({
    url: "https://portal-simtaru.kaltimprov.go.id/server/rest/services/POLA_RUANG_KALTIM_2023/MapServer"
  })
});

const map = new Map({
  target: "map",
  layers: [new TileLayer({ source: new OSM() }), polaRuang],
  view: new View({ center: [12968600, 56000], zoom: 7 })
});

3. Leaflet + Esri Leaflet

Leaflet dapat mengakses ArcGIS REST Map Service melalui plugin Esri Leaflet. Tambahkan esri-leaflet, lalu gunakan L.esri.dynamicMapLayer untuk overlay Map Service.

JavaScript Leaflet Esri dynamicMapLayer

import L from "leaflet";
import "esri-leaflet";

const map = L.map("map").setView([0.5, 116.5], 7);
L.tileLayer("https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png", {
  attribution: "&copy; OpenStreetMap contributors"
}).addTo(map);

const polaRuang = L.esri.dynamicMapLayer({
  url: "https://portal-simtaru.kaltimprov.go.id/server/rest/services/POLA_RUANG_KALTIM_2023/MapServer",
  opacity: 0.72
}).addTo(map);

const strukturRuang = L.esri.dynamicMapLayer({
  url: "https://portal-simtaru.kaltimprov.go.id/server/rest/services/Struktur_Ruang/STRUKTUR_RUANG/MapServer"
}).addTo(map);

Identifikasi dan query

Untuk memperoleh atribut feature, gunakan endpoint sublayer (/MapServer/{id}) dan kemampuan query. Lakukan request /query dengan geometri lokasi, parameter spatialRel=esriSpatialRelIntersects, outFields=*, serta f=json.

Catatan implementasi

Gunakan HTTPS untuk menghindari mixed-content di aplikasi produksi.
Uji CORS dari domain aplikasi Anda sebelum mengakses feature query langsung dari browser.
Gunakan opacity dan urutan layer agar Pola Ruang tidak menutupi jaringan Struktur Ruang.
Periksa metadata, field, skala, dan tanggal pembaruan data sebelum memakai hasil untuk proses teknis resmi.

Jangan menanam kredensial Portal atau token administratif pada kode frontend. Bila suatu layanan dibatasi, gunakan mekanisme autentikasi ArcGIS Enterprise yang sesuai melalui backend atau identity manager.

Kontak Kami

Social Links