PNG Address Hub
HOME - our portfolio - png address hub
PNG Address Hub
Industry
Government / Location Intelligence
Built for
Web
Country
Papua New Guinea
Region
Oceania (Pacific)
Timeline
2024 – 2025
Project Description
PNG Address Hub is a national digital address infrastructure platform built by TTPL for Papua New Guinea — a country that, like much of the Pacific, has historically lacked a standardized, machine-readable addressing system. The platform establishes a comprehensive, structured geographic database covering PNG's full administrative hierarchy and exposes it as a managed API service that businesses and government agencies can integrate into their own systems.
The system organizes Papua New Guinea's geography into a precise six-level hierarchy: Province → District → LLG (Local Level Government) → Ward → Town → Suburb, extending further into Streets, Section Numbers, and Allotment Numbers for fine-grained physical addressing, as well as a parallel Post Office and PO Box layer for postal addressing. The database currently holds over 11,000+ geographic records covering the entirety of PNG's provinces, districts, and wards.
Beyond the geographic layer, PNG Address Hub provides a Business Registry where organizations can be registered with their addresses, contacts, and mapped services — enabling it to function as both an address lookup platform and a national business directory. A Client Configuration module with API key management and rate limiting allows external systems to securely consume address data at controlled request volumes.
Goal
The goal of PNG Address Hub was to build a centralized, authoritative address database for Papua New Guinea — a country where standardized physical addressing has historically been absent or inconsistent. The platform needed to digitize PNG's full geographic hierarchy and make it accessible to businesses, developers, and government agencies through a managed, secure API.
- Establish a structured, hierarchical address database covering all PNG provinces, districts, LLGs, wards, towns, and suburbs
- Support both physical addressing (street, section, allotment) and postal addressing (PO Box, post office) in a single unified model
- Provide a business registry with address mapping and service categorization
- Enable secure, rate-limited API access for external client applications via configurable API keys
- Deliver an admin platform for ongoing data management, client onboarding, and activity monitoring
- Build a scalable, maintainable architecture capable of evolving as PNG's address infrastructure grows
Challenges
No Existing Address Standard to Build On: Papua New Guinea lacks a nationally adopted addressing standard. The platform had to define, model, and implement a new address hierarchy from scratch — balancing PNG's formal administrative divisions (Province, District, LLG, Ward) with the practical addressing realities of towns, suburbs, streets, sections, and allotments used on the ground.
Dual Address Type Complexity: PNG uses both physical addresses (street-level) and postal addresses (PO Box at post offices) as primary address identifiers for businesses and individuals. Modeling both types within a single coherent address entity — while keeping the data entry experience clean — required careful schema and UX design.
API Access Management with Rate Limiting: The platform needed to expose address data to multiple third-party clients (businesses, payment platforms, government portals) simultaneously, each with their own API key, rate limits, and access controls — without compromising data integrity or performance under concurrent load.
Scale of Geographic Data: Accurately loading and structuring PNG's 22 provinces, hundreds of districts, thousands of LLGs, wards, and localities into a relational database required extensive data normalization and validation work before the system could be useful in production.
Solutions
Six-Level Geographic Hierarchy Engine
We modeled PNG's complete address structure as a six-level relational hierarchy: Province → District → LLG → Ward → Town → Suburb — with Street, Street Details, Section Number, and Allotment Number as terminal addressing layers. Every level is fully managed through dedicated CRUD interfaces in the admin panel, allowing the address data to evolve and expand over time without schema changes. The hierarchy is enforced at both the database and API validation layers.
Unified Physical and Postal Address Model
A single Address entity accommodates both physical addressing (street, section number, allotment, landmark, small village/building name) and postal addressing (PO Box number, post office association) under a common address type flag. This unified model means businesses and individuals with either a street address or a PO Box — or both — can be accurately represented in a single record, eliminating the need for separate data models or parallel systems.
Business Registry with Address and Service Mapping
The platform includes a full business registration module where organizations are recorded with their legal identity (name, registration number, tax number, business type, date of incorporation) alongside their contacts and a many-to-many address mapping. Businesses can additionally be mapped to one or more services from a categorized service directory — enabling PNG Address Hub to serve as both an address lookup and a national business directory for downstream applications.
API Client Management with Rate Limiting
A dedicated Client Configuration module allows administrators to onboard external API consumers — assigning each client a unique API key, defining their allowed server URL, and configuring precise rate limits (maximum requests per time window in seconds). This enables PNG Address Hub to safely serve multiple external platforms — payment processors, government portals, logistics systems — from a single address API with per-client traffic controls and audit visibility.
Real-Time Admin Dashboard & Data Visibility
The admin dashboard provides a live overview of platform health: total client counts with 7-day and 365-day trend charts, and a comprehensive data breakdown showing record counts across every table in the system — Wards (6,444), Streets (3,057), Service Types (732), Suburbs (211), LLGs (87), and more. This gives administrators immediate insight into data completeness and platform activity without requiring manual database queries.
Structured Audit Logging with Serilog
All platform activity — user actions, data changes, API access events — is captured through a structured Serilog pipeline writing to SQL Server. The LogEvents module in the admin panel exposes this audit trail with filtering and search capabilities, providing full accountability for all data management operations and enabling compliance review for government and enterprise clients.
