Panduan Full Stack & Backend Engineer: PostGIS, GeoDjango & Mapbox Vector Tiles Skala Besar
Merender 500.000 poligon logistik langsung, koridor transportasi, atau batas properti sebagai GeoJSON mentah melalui REST API akan menserialisasi lebih dari 80 megabyte JSON dan membuat memori peramban seluler mogok. Sebagai full stack engineer dan backend engineer yang membangun platform pelacakan armada geospasial dan transportasi perkotaan (termasuk alat visualisasi MRT Jakarta), saya merancang pipa spasial throughput tinggi menggunakan indeks GiST PostgreSQL PostGIS, GeoDjango, dan Mapbox Vector Tiles sisi server (ST_AsMVT).
1. Pengindeksan Spasial GiST dan Sistem Koordinat Terproyeksi
Kesalahan umum pada basis data geospasial adalah menjalankan kueri jarak pada kolom lintang/bujur tanpa indeks menggunakan rumus Haversine di memori aplikasi, atau mencampur SRID 4326 (derajat WGS 84) dengan perhitungan buffer berbasis meter. Menyimpan geometri sebagai geography(Point, 4326) atau memproyeksikan poligon regional ke koordinat planar akurat meter dengan indeks Generalized Search Tree (USING GIST) memangkas kueri tetangga terdekat dan kotak pembatas dari hitungan detik menjadi di bawah 3 milidetik.
2. Menghasilkan Mapbox Vector Tiles (MVT) Langsung di PostGIS
Alih-alih menserialisasi ribuan model ORM Django ke GeoJSON, kita membiarkan PostgreSQL memotong, menyederhanakan, dan menyandikan geometri langsung ke ubin vektor biner Protocol Buffer (application/vnd.mapbox-vector-tile) menggunakan ST_AsMVT dan ST_AsMVTGeom:
# views/mvt_tiles.py
from django.db import connection
from django.http import HttpResponse, Http404
def parcel_vector_tile_view(request, z: int, x: int, y: int) -> HttpResponse:
if not (0 <= z <= 22):
raise Http404("Invalid zoom level")
sql = '''
WITH tile_bounds AS (
SELECT ST_TileEnvelope(%s, %s, %s) AS geom_3857
),
mvt_features AS (
SELECT
p.parcel_id,
p.zoning_code,
p.assessed_value_usd,
ST_AsMVTGeom(
ST_Transform(p.boundary_geom, 3857),
tile_bounds.geom_3857,
4096,
256,
true
) AS geom
FROM spatial_parcels p
CROSS JOIN tile_bounds
WHERE p.boundary_geom && ST_Transform(tile_bounds.geom_3857, 4326)
AND p.is_active = true
)
SELECT ST_AsMVT(mvt_features.*, 'parcels', 4096, 'geom')
FROM mvt_features
WHERE geom IS NOT NULL;
'''
with connection.cursor() as cursor:
cursor.execute(sql, [z, x, y])
row = cursor.fetchone()
mvt_bytes = bytes(row[0]) if row and row[0] else b""
response = HttpResponse(mvt_bytes, content_type="application/vnd.mapbox-vector-tile")
response["Cache-Control"] = "public, max-age=300, stale-while-revalidate=600"
return response
3. Pencarian Kurir K-Nearest Neighbor (KNN) Sub-10ms
Untuk pencocokan pengiriman waktu nyata, operator jarak kotak pembatas <-> PostGIS menelusuri pohon indeks GiST secara langsung guna mengembalikan kurir aktif terdekat tanpa memindai tabel.