Skip to end of metadata
Go to start of metadata

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:

Geolocation:

  • No labels