Introduction

For static locations, using Civic Address location descriptions would be the easiest method. As stated earlier though, you and your partners must agree on which description formats are acceptable.

The following tables list the IANA registered element names that are currently accepted. The complete list of codes is defined in:
https://www.iana.org/assignments/civic-address-types-registry/civic-address-types-registry.xhtml

These codes were originally defined in RFC4119 and RFC4776

Label	Description	Example
country	The country is identified by the two-letter ISO 3166 code.	US
A1	national subdivisions (state, region, province, prefecture)	New York
A2	county, parish, gun (JP), district (IN)	King's County
A3	city, township, shi (JP)	New York
A4	city division, borough, city, district, ward, chou (JP)	Manhattan
A5	neighborhood, block	Morningside Heights
A6	street NOTE: This code has been deprecated in favor of `RD`, defined below.	Broadway
PRD	Leading street direction	N, W
POD	Trailing street direction	SW
STS	Street suffix	Avenue, Platz, Street
HNO	House number, numeric part only	123
HNS	House number suffix	A, 1/2
LMK	Landmark or vanity address	Low Library
LOC	Additional location information NOTE: `ROOM` was added below.	Room 543
FLR	Floor	5
NAM	Name (residence, business or office occupant)	Joe's Barbershop
PC	Postal code	10027-0401

These codes were added in RFC5139

Label	Description	Example
BLD	Building (structure)	Hope Theatre
UNIT	Unit (apartment, suite)	12a
ROOM	Room	450F
PLC	Place-type	office
PCN	Postal community name	Leonia
POBOX	Post office box (P.O. box)	U40
ADDCODE	Additional Code	13203000003
SEAT	Seat (desk, cubicle, workstation)	WS 181
RD	Primary road or street	Broadway
RDSEC	Road section	14
RDBR	Road branch	Lane 7
RDSUBBR	Road sub-branch	Alley 8
PRM	Road pre-modifier	Old
POM	Road post-modifier	Service

These codes were added in RFC6848

Label	Description	Example
PN	Post number that is attributed to a lamp post or utility pole.	21344567
MP	Milepost: a marker indicating distance to or from a place (often a town) May actually be expressed in "miles" or "kilometers".	237.4
STP	Street Type Prefix.	Boulevard
HNP	House Number Prefix.	Z

Example Configurations

Simple Example 1

In geolocation.conf, we can define a location that describes a building and profiles for Bob and Alice that add floor and room. We're assuming here that Bob's and Alice's phones don't send any location information themselves.

PIDF-LO XML Examples

Here's what Alice's PIDF-LO would look like:

Here's what Bob's PIDF-LO would look like:

Note that the only civicAddress difference between the two are the FLR and ROOM.

Table of Contents:

Introduction
Example Configurations
- Simple Example 1
PIDF-LO XML Examples

Geolocation:

Expand all Collapse all