GeoDirectory Technical
Guide
Maintained by:
Dominic Fahey
Date Modified
Document Name
Document Version
May 2013
GeoDirectoryTechnicalGuide V10.doc
10.2
______________________________________________________________________________
© Copyright 2013 An Post / Ordnance Survey Ireland. All Rights Reserved.
An Post / Ordnance Survey Ireland
GeoDirectory Technical Guide
Table of Contents
1. DOCUMENT CONTROL ............................................................................................. 4
2. Introduction.................................................................................................................. 5
2.1
2.2
2.3
2.4
2.5
GeoDirectory .........................................................................................................................5
This Document ......................................................................................................................5
Intended Audience ................................................................................................................5
Value Added Re-Sellers .......................................................................................................5
Contacting GeoDirectory ......................................................................................................5
3. Overview of GeoDirectory ............................................................................................ 6
3.1
Sources of Data ....................................................................................................................6
3.1.1.
3.1.2.
3.1.3.
3.2
3.3
Coverage ..............................................................................................................................6
Quality of Data ......................................................................................................................7
3.3.1
3.3.2
3.3.3
3.3.4
3.3.5
3.4
3.5
OSi Mapping Database................................................................................................................. 6
An Post Ground Validation. .......................................................................................................... 6
OSi Administrative Boundary Database ........................................................................................ 6
Accuracy ...................................................................................................................................... 7
Consistency .................................................................................................................................. 8
Completeness .............................................................................................................................. 8
Currency....................................................................................................................................... 8
External validation ........................................................................................................................ 8
Maintenance of GeoDirectory ...............................................................................................8
Geo Co-ordinates..................................................................................................................9
3.5.1
3.5.2
3.5.3
Irish Grid....................................................................................................................................... 9
Irish Transverse Mercator ............................................................................................................. 9
ETRS89 (Latitude and Longitude)................................................................................................. 9
4. Extranet site .............................................................................................................. 10
4.1
4.2
Data Supply ........................................................................................................................ 10
Customer feedback ............................................................................................................. 10
5. Address Modelling ..................................................................................................... 11
5.1
5.2
5.3
5.4
5.5
Address Elements ............................................................................................................... 11
Populating the Address Modelling tables. .......................................................................... 12
Stage 1 – Selecting Candidates ......................................................................................... 13
Stage 2 – Rendition instructions ......................................................................................... 14
Examples of Addresses ...................................................................................................... 16
6. GeoDirectory Database schemas .............................................................................. 20
6.1
6.2
6.3
Data diagram ...................................................................................................................... 20
Table Descriptions .............................................................................................................. 23
Updates & Deletions ........................................................................................................... 25
7. GeoDirectory Products .............................................................................................. 26
7.1
7.2
7.3
Product Portfolio ................................................................................................................. 26
Detailed Product Descriptions ............................................................................................ 26
Sub-sets of Data ................................................................................................................. 33
7.3.1
7.3.2
Sub-sets by Product ................................................................................................................... 33
Sub-sets by Customer Request .................................................................................................. 33
8. Data Formats ............................................................................................................. 34
8.1
Product Data Formats ......................................................................................................... 34
8.1.1
8.1.2
8.1.3
8.2
CSV File ..................................................................................................................................... 34
CSV File Layouts ........................................................................................................................ 35
XML File Layouts ........................................................................................................................ 41
Character Formats .............................................................................................................. 41
9. Integrating the GeoDirectory Database...................................................................... 42
9.1
9.2
10.
Integrating databases without GeoDirectory ...................................................................... 42
Integrating databases with GeoDirectory ........................................................................... 42
How to Manage GeoDirectory Releases ........................................................... 43
10.1 Update your database with the changes since the last release. ........................................ 43
10.2 Replace with New Release ................................................................................................. 44
10.3 Where to store additional in-house addresses ................................................................... 45
10.3.1
10.3.2
10.3.3
In transactional database............................................................................................................ 45
In GeoDirectory .......................................................................................................................... 45
Address Repository .................................................................................................................... 46
______________________________________________________________________________
Page 2 of 76
An Post / Ordnance Survey Ireland
11.
GeoDirectory Technical Guide
Integrating GeoDirectory with GIS .................................................................... 47
11.1 ARCGIS .............................................................................................................................. 47
11.2 MAPINFO ............................................................................................................................ 51
Appendix A – Legal statement........................................................................................ 54
Appendix B – Irish Grid .................................................................................................. 55
Appendix C – ITM Co-ordinates ..................................................................................... 56
Appendix D – ETRS89 CO-ORDINATED ....................................................................... 57
Appendix E – Boundary data Sets.................................................................................. 58
Appendix F – Database Column Descriptions ................................................................ 59
Appendix G – History of Technical Changes .................................................................. 71
______________________________________________________________________________
Page 3 of 76
An Post / Ordnance Survey Ireland
1.
GeoDirectory Technical Guide
DOCUMENT CONTROL
Details:
Authors:
Owner:
Dominic Fahey, An Post and Fred Finch, Ordnance
Survey Ireland
GeoDirectory Ltd.
Document Number
GeoDirectoryTechnicalGuide V10.doc
Version History:
Version
Date Released
9.1
9.2
9.3
9.4
9.5
10.0
10.1
July 2010
October 2010
July 2011
March 2012
May 2012
July 2012
November 2012
10.2
May 2013
Description
To reflect the changes to the database structure
Changes to the rules when populating the address model table.
Releasing the Official Postal Address
Releasing the Small Areas boundary and the CSO Electoral Division
link Identification Number.
Releasing data for Buildings Datum, District Courts and Additional
Features.
Note:
See appendix G for a detailed description of changes.
______________________________________________________________________________
Page 4 of 76
An Post / Ordnance Survey Ireland
2.
GeoDirectory Technical Guide
INTRODUCTION
2.1 GeoDirectory
GeoDirectory is a collaboration between An Post and Ordnance Survey Ireland (OSi), the experts in postal
and geographic addressing in Ireland.
The purpose of GeoDirectory is to create a definitive reference directory of addresses in Ireland and to
assign to them accurate postal and geographic addresses.
A postal address is the address used to enable delivery of mail. GeoDirectory proposes a standard address
format, which is intended to become the address format used by organisations and individuals throughout the
country. Use of an agreed address format will enable faster delivery of mail and facilitate sharing of data
between and within organisations.
A geographic address is a combination of East and North values which accurately position a building on the
surface of the Earth. Geographic addresses, also known as geo-codes, are commonly used by Geographic
Information Systems (GIS) to position addresses on maps.
For the first time ever, GeoDirectory combines accurate postal and geographic addresses for Ireland in one
database and makes this database available to organisations and individuals who require it. It thus provides
a basic infrastructure which will become invaluable across all industry sectors.
2.2 This Document
This is a technical document intended to answer technical questions about the structure of the standard
address models, the GeoDirectory database and GeoDirectory products.
GeoDirectory products may be leased either directly from GeoDirectory or through Value Added Re-sellers /
Agents. This document describes only those products which are available directly from GeoDirectory.
This document is freely available to anyone who either has leased or is contemplating the leasing of
GeoDirectory. An electronic copy of the document can be found on our Web Site.
2.3 Intended Audience
The GeoDirectory Technical Guide has been written for technical users of GeoDirectory, both in end-user
organisations and in Value Added Re-seller organisations.
2.4 Value Added Re-Sellers
A list of current authorised Value Added Re-seller organisations is available by contacting GeoDirectory, or
by visiting our web site.
2.5 Contacting GeoDirectory
GeoDirectory can be contacted by any of the following methods:
Mail:
GeoDirectory
GPO,
O‘Connell St. Lower,
Dublin 1.
Phone:
Fax:
E-Mail:
Web:
(01) 7057005 or from outside Ireland at +353 1 7057005
(01) 7057160 or from outside Ireland at +353 1 7057160
[email protected]
www.geodirectory.ie
______________________________________________________________________________
Page 5 of 76
An Post / Ordnance Survey Ireland
3.
GeoDirectory Technical Guide
OVERVIEW OF GEODIRECTORY
The current GeoDirectory products are data-only products, unlike most software products which include user
interfaces. This section provides some background information on the GeoDirectory data i.e. where it came
from, how it is managed and how data quality is assured.
3.1 Sources of Data
The main sources of data for GeoDirectory are:
•
•
•
•
OSi Large Scale Map Database.
OSi Aerial Photography (Ortho-photography).
An Post ground validation.
Feedback from internal usage
•
•
•
Automated Mail Sorting
CRM Systems
OSi Ground Surveyors
3.1.1. OSi Mapping Database.
OSi Large Scale Map Database contains the geographical location of Urban, Sub-urban and Rural
buildings. Urban areas which cover all the major towns and cities in Ireland at a scale of 1:1000 are
updated annually. Sub-urban areas at a scale of 2,500 are also updated annually. Rural areas at a scale
of 2,500 are updated on a 3 year cycle and Rural areas at a scale of 5,000 are updated on a 5 year cycle.
Using a semi-automatic data collection process, all buildings are identified and stored in GeoDirectory,
using OSi's Geographical Information System (GIS) address software.
3.1.2. An Post Ground Validation.
Using a Clár (list of all the addresses on a postal route), and the OSi Large Scale maps, all Postal
Delivery Persons in An Post now maintain GeoDirectory. With the Delivery Person passing each building
daily, the data such as change of building use, change of businesses, building no, building names, etc. is
confirmed or amended if necessary and additional details may be added. New buildings are added by
recording the address on blank forms and marking the position of the building on the map. The details are
then fed back into the database to form the basis of the GeoDirectory data products.
3.1.3. OSi Administrative Boundary Database
Administrative Boundary attributes (County, ED, and Townland) are automatically added to the database
using the OSi administrative boundary database and Geographical Information Systems (GIS) software.
GeoDirectory now includes the Small Area Boundary Set. This set is a sub-ED level geography, which
will have a homogenous design to enable proper and reliable comparable statistical potential. If you
require this dataset you must order it separately from GeoDirectory.
3.2 Coverage
GeoDirectory contains addresses for the Republic of Ireland. The database will never be 100% complete as
it‘s continuously being updated with new addresses, modified addresses, and demolition of existing buildings
(the BUILDING_ID is retained in case of future development on the site). The total number of valid buildings
currently in the database is circa 1,893,508 (March 2013) but is growing daily as new address points are
identified. In 2012 we added 12.6K new buildings which are roughly in line with the Housing build figures
from the Department of Environment.
______________________________________________________________________________
Page 6 of 76
An Post / Ordnance Survey Ireland
GeoDirectory Technical Guide
3.3 Quality of Data
This section discusses the quality of GeoDirectory data under a number of headings.
3.3.1 Accuracy
Geo-codes
The purpose of a geocode is to provide a unique geographic reference for each valid building in the
Database. A geocode is a set of generated x and y co-ordinates based on either the Irish Grid, Irish
Transverse Mercator (ITM) reference systems or as LAT & LONG on the ETRS89 system. There
are three distinct methods of collecting the geocodes, each method has its own relative accuracy
level and this is indicated by an entry in the QUALITY_CONTROL field on the buildings table. These
accuracy levels are as follows:-
Accuracy Level 1 (MAP)
Level 1 is based on the position of a building as indicated on the most up-to-date OSi mapping. The
geocode should be accurate to within 1 metre of its map position.
Accuracy Level 2 (ORTHO)
Level 2 is based on the position of a building as indicated on OSi ortho-photography. The geocode
should be accurate to within 1 metre of its position on the ortho-photograph.
Accuracy Level 3 (AN POST)
Level 3 is based on the position of a new building as indicated by An Post personnel on the ground,
where no building exists on current mapping or ortho-photography. The accuracy level is upgraded
when the building is captured on new mapping or new ortho-photography.
Note 1:
The geo-code on a GeoDirectory building is only valid if the Verified flag = ‗Y‘ and the Invalid flag =
‗N‘.
Note 2:
OSi are continuously generating new maps. As these new maps become available the geo-codes
on buildings which were collected from county series maps are moved to new positions. Where this
happens, users of GeoDirectory will receive updated geo-codes for these address points with the
next release. Where new addresses are located by An Post and the building is not on an OSi map
then an approximate position will be given.
Note 3:
Less than 0.7% (Jan 2013) of the Buildings are at level 3 (An Post) with the reminder at level 1 & 2.
Spelling
Thoroughfare names are entered into GeoDirectory as recorded from the Thoroughfare nameplate.
OSi also verifies this spelling with the relevant local authorities for accuracy. Other legal place
names and Irish spelling are as determined by OSi.
Building Attributes
Building attributes such as building number, name, number of address points etc. are accurate as of
the day they were validated on the ground by An Post.
Irish Translations
GeoDirectory endeavours to include the official translation of names within the database. The
IRISH_VERIFICATION field on any table that contains an Irish translation indicates whether or not
the translation was verified by the Placenames Branch of the Department of Community, Rural and
Gaeltacht Affairs. It is envisaged at this stage to only translate Building Groups, Thoroughfares,
Localities, Towns, Post Towns and Counties names.
______________________________________________________________________________
Page 7 of 76
An Post / Ordnance Survey Ireland
GeoDirectory Technical Guide
3.3.2 Consistency
The GeoDirectory database is stored centrally, and updated by a dedicated group of trained staff.
Procedures are in place to ensure that data entered is checked and double-checked. Stringent
database constraints enforce referential integrity throughout the database and QA scripts are run
and checked on a regular basis to highlight possible issues with the data.
Rules for creating postal addresses are outlined later in this document. These rules are applied
consistently for all addresses in the database.
The quality of data is therefore consistent throughout the database.
3.3.3 Completeness
Both Urban and rural addresses for the Republic of Ireland are included in the database. The
GeoDirectory data is in its nature historical, representing a snapshot at the time of updating. We
make every effort to be up to date with all current buildings and addresses, but there can be a lag
between the creation of new addresses and them appearing in the database.
3.3.4 Currency
Currency is a measure of the real-world change included in GeoDirectory. The database supports
the following:
Change Date:
The latest date on which one of its attributes has changed.
The change date is applied at record level i.e. for each address point, building, thoroughfare etc.
The use of dates is further explained in the section ―GeoDirectory Database Schema‖.
The GeoDirectory team has endeavoured to ensure that the database content reflects the situation
on the ground on the date of validation. We do however welcome all feedback on the quality of the
GeoDirectory data.
3.3.5 External validation
3.4 Maintenance of GeoDirectory
The Delivery Staff in An Post capture and maintain the GeoDirectory addresses and attributes. OSi
continuously add new buildings they find during their map revision cycle and maintain the geocoding and
Administrative Boundaries information. This data is fed into the GeoDirectory database and release six times
a year.
______________________________________________________________________________
Page 8 of 76
An Post / Ordnance Survey Ireland
GeoDirectory Technical Guide
3.5 Geo Co-ordinates
3.5.1 Irish Grid
Geographical co-ordinates on Irish Grid are based on a false origin 200 kilometres west and 250
o
o
kilometres south of Latitude 8 00‘ 00‖ W and Longitude 53 30‘ 00‖ N, based on the Transverse
Mercator Map Projection on the Airy Modified ellipsoid.
Each address is given a geo-code (distance in Eastings and Northings from the false origin) to three
decimal places. These can be stripped back to the nearest metre if necessary i.e.
East
314654.256
North
239127.462
to
East
314654
North
239127
Further details on the Irish Grid are given in Appendix B of this document.
3.5.2 Irish Transverse Mercator
Since the 1960's, all OSi and OSNI mapping has been based on the local coordinate reference
system, the Irish Grid (IG). To maximise the potential for precise positioning offered by new
technology, and in particular the Global Positioning System (GPS), the Ordnance Surveys have
established a new GPS control network within Ireland (IRENET95), which relates to the European
Terrestrial Reference System (ETRS89).
With the increasing use of GPS in the survey and G.I. industries, the Ordnance Surveys have
recognised a need to provide mapping that is fully compatible with GPS. This has led to the
development of a new coordinate reference system for Ireland, known as ITM (Irish Transverse
Mercator). All OSI data is now available in both IG and ITM. In order to meet the needs of the
growing numbers of GeoDirectory users who have migrated to ITM, the GeoDirectory product now
contains coordinates in both reference systems.
Further details on the Irish Transverse Mercator are given in Appendix C of this document.
3.5.3 ETRS89 (Latitude and Longitude)
ETRS89 geographic co-ordinates are the Latitude and Longitude equivalents of ITM grid coordinates. They originate from a Control Network (IRENET) which was observed in 1995 and
connected to the defining International Terrestrial Reference Frame (ITRF) stations in Europe. The
resulting adjustment was accepted as an official extension to the European Terrestrial Reference
System (ETRS) by EUREF in 1996.
We supply the Latitude and Longitude in Degrees and decimal parts of a degree and one second of
arc is equivalent to about 30 metres in Latitude and 20 metres in Longitude.
Further details on the ETRS89 are given in Appendix D of this document.
______________________________________________________________________________
Page 9 of 76
An Post / Ordnance Survey Ireland
4.
GeoDirectory Technical Guide
EXTRANET SITE
We maintain an extranet site on www.geodirectory.ie for customers of GeoDirectory Ltd. This allows them
download their customised data sets and give constructive feedback on the quality of the data. They can
obtain up to date information and downloads including:-






View our update cycle including areas completed and the next to be visited.
A selection of Technical FAQ's that can be used as a point of reference.
Download an Access viewer.
Obtain quotes.
Because the Electoral Divisions identifiers from OSI and CSO differ there is a downloadable table
which links the two.
Receive regular updates on IT projects and their timelines when they are being implemented by
GeoDirectory.
4.1 Data Supply
GeoDirectory now supplies data through its extranet site. To access this site you must register and obtain a
username and password so please contact us to setup your account.
4.2 Customer feedback
Feedback is welcomed and there is a facility on the extranet site which allows customers raise and track
queries.
______________________________________________________________________________
Page 10 of 76
An Post / Ordnance Survey Ireland
5.
GeoDirectory Technical Guide
ADDRESS MODELLING
GeoDirectory address modelling seeks to define the key elements of Irish addresses in order to facilitate a
common understanding of what an address is and encourage the use of consistent addressing by any
organisation.
There are a number of key benefits in establishing and using a common address model, including:
•
•
•
Facilitate data sharing between organisations
Provide a key data set to the geographic information industry
Improved quality of service for mail delivery
5.1 Address Elements
The elements are as follows
Name
Premise
Personal Name
This is a person‘s name. GeoDirectory does not hold
personal names.
Department
The department or division within an organisation. If the
department element exists, then the organisation must
also exist
Organisation
The name or initials of an organisation e.g. An Post.
Sub Building Name
The sub-building refers to an apartment, flat or unit
within a building.
Building Name
A name given to the building.
Building Number
A number associated with the whole building, including
number ranges e.g. 120-126 and composite numbers
e.g. 2A that relate to the whole building and not a subunit within it. Examples of numbering system are:
The ‗/‘ indicates two numbers.
e.g.
63/64 is No. 63 and No. 64.
e.g.
63/65 is No. 63 and No. 65
The ‗_‘ indicates a range of numbers in a sequence.
e.g.
1_5 is 1,3 and 5
2_6 is 2,4 and 6
The ‗–‗ indicates a range of consecutive numbers
e.g.
63-66 is 63,64,65 and 66
Building Group
Building Group Name
A building group is a group of two or more buildings with
a collective name, located on the same thoroughfare.
The buildings in the building group are usually numbered
within the building group, not within the thoroughfare.
Examples include universities, hospitals, some industrial
estates, some terraces, shopping centres, apartment
complexes etc.
______________________________________________________________________________
Page 11 of 76
An Post / Ordnance Survey Ireland
Thoroughfare
Area
GeoDirectory Technical Guide
Primary Thoroughfare
The name of the thoroughfare on which the
premise is located.
Secondary
Thoroughfare
The name of a thoroughfare which uniquely
identifies a primary thoroughfare. This field will be
populated where a secondary thoroughfare is
essential to distinguish two primary thoroughfares
of the same name within the same postal district or
town.
Primary Locality
The name of the locality in which the address falls.
In urban areas, the primary locality can be required
to distinguish between two thoroughfares of the
same name in the same district or town. Industrial
estates with named thoroughfares are also held as
localities. In rural areas the primary locality is
generally a townland name.
Secondary Locality
The name of a locality which serves to differentiate
primary localities of the same name within the
same post-town area or county. Secondary
Locality will generally only be required for rural
addresses.
Post-town
The name of a town or postal district associated
with the premise for postal delivery purposes.
County
The name of the county inside which the Building
falls.
5.2 Populating the Address Modelling tables.
There are four (4) tables in the Address Modelling group called:1.
2.
3.
4.
GEOGRAPHIC_FORMAT
IRISH_GEOGRAPHIC_FORMAT
OFFICIAL_POSTAL_ADDRESS
IRISH_OFFICIAL_POSTAL_ADDRESS
The populating of these tables is a two part process. First we decide which addresses are candidates for
inclusion and populate the first 15 columns of the address model table. Secondly we construct the address
from these columns and populate Address Lines 1 to 10.
Note 1: The rules for populating the Irish version of the tables are the same as the English version except
that the source will be the Irish_Name fields. In the event that the Irish translation is not available use the
English version of the name.
Note 2: When populating the GEOGRAPHIC_FORMAT table the decision to include or exclude the Post
Town is sources from the Post_Town_Required flag on the Localities table.
Note 3: When populating the OFFICIAL_POSTAL_ADDRESS table the decision to include or exclude the
Post Town is sources from the Post_Town_Required_AP flag on the Localities table.
______________________________________________________________________________
Page 12 of 76
An Post / Ordnance Survey Ireland
GeoDirectory Technical Guide
5.3 Stage 1 – Selecting Candidates
The address modelling group tables are populated by copying data from 7 other tables for each address.
These 7 tables are:
1.
2.
3.
4.
5.
6.
7.
BUILDINGS
ADDRESS_POINTS
BUILDING_GROUPS
THOROUGHFARES
LOCALITIES
POST_TOWNS
COUNTIES
The rules for populating the fields are as follows:
•
•
•
•
•
If a building has 0 residential delivery points and 0 commercial delivery points, then no row is inserted
into the tables for that building, as it does not receive mail.
Buildings with a value of ―Y‖ in the ―invalid‖ field are not copied to the tables.
If a building has no valid address_points in the address_points table then one row is inserted into the
tables for that building.
If a building has one valid address_point in the address_points table then one row is inserted into the
tables for that building.
If a building has more than one valid address_point in the address_points table then one row for each
address_point is inserted into the tables.
Constraints:
•
The Organisation Name:-
•
•
The Building Name:-
If the Building Name is the same as Building Group then Building Name is not shown
-
If the Building Name is the same as Organisation then Building Name is not shown
The Building Group:-
•
If a building has an associated building_group, and that building_group has a value of ―N‖ in the
―thoroughfare_postally_required‖ field, then the Primary and Secondary Thoroughfare fields are left blank.
The Locality:-
•
If the name is the same as Organisation then Building Group is not shown
The Thoroughfare:-
•
If the ‗Include_Org_Name’ flag is set to ‗N‘ in the address_points table then the Organisation_Name field is
left blank.
If a building has an associated Locality_id and the 'Locality_Postally_Req' field is set to 'N', then the
Locality and Secondary Locality field is left blank.
The Post Town:-
If the primary Locality has the post_town_required flag set to ‗Y‘ for the GEOGRAPHIC_FORMAT table or
post_town_required_ap set to ‗Y‘ for the OFFICIAL_POSTAL_ADDRESS table then the post_town name
should be included, otherwise exclude the Post Town.
-
If there is no Locality then the post_town must be included.
-
If the Post Town is in a Dublin Numbered District e.g. ―Dublin 1‖, and the Post Town Required is set to 'Y' or
no locality is used, then the County field is left blank, else show the County.
-
If the post_town name is the same as the County name, then the county field is left blank in the tables and
the post_town field is populated.
-
If the post_town name is the same as the Locality name, then the locality field is left blank in the tables.
-
If the post_town name is the same as the Secondary Locality name, then the Secondary_Locality field is left
blank in the tables.
-
If the post_town name is the same as the Thoroughfare name, then the thoroughfare field is left blank in the
tables.
-
If the post_town name is the same as the Secondary Thoroughfare name, then the secondary_thoroughfare
field is left blank in the tables.
______________________________________________________________________________
Page 13 of 76
An Post / Ordnance Survey Ireland
GeoDirectory Technical Guide
The database tables from which each column is extracted from is shown below.
Column Names
BUILDING_ID
ADDRESS_POINT_ID
PERSONAL_NAME
ORGANISATION_NAME
DEPARTMENT
SUB_BUILDING_NAME
BUILDING_NAME
BUILDING_NUMBER
BUILDING_GROUP_NAME
THOROUGHFARE
SECONDARY_THOROUGHFARE
LOCALITY
SECONDARY_LOCALITY
POST_TOWN
COUNTY
Database table from which this
column is populated
BUILDINGS
ADDRESS_POINTS
Not populated
ADDRESS_POINTS
ADDRESS_POINTS
ADDRESS_POINTS
BUILDINGS
BUILDINGS
BUILDING_GROUPS
THOROUGHFARES
THOROUGHFARES
LOCALITIES
LOCALITIES
POST_TOWNS
COUNTIES
5.4 Stage 2 – Rendition instructions
Rendition instructions define how address elements are rendered when printed on a mail piece or displayed
on a screen.
Name Elements



Personal names are not included in the GeoDirectory product, but may
be included by other organisations.
A department name may exist if the organisation name exists.
An organisation name may exist for an address.
If any or all of these elements are present, they should appear on separate lines in the
above sequence, but in the case of the Organisation name the INCLUDE_ORG_NAME
field must also be set to ‗Y‘.
Sub-Building Name

A sub-building name (e.g. ―Flat 1‖, ―Apartment 1‖, ―Unit 1‖ or just ―1‖)
may exist.
 If it starts with an alphabetic character (A-Z) it will appear next on a separate line.
 If it starts with a numeric character (0-9) then it will appear alongside the Building
Name.
 If it starts with a numeric character (e.g. 10A) and there is no Building Name but
there is a Building Number the Sub-Building Name will appear next on a separate
line.
 If it starts with a numeric character and there is no Building Name or Building
Number, the Sub-Building Name will appear alongside the next one of Building
Group, Thoroughfare, Secondary Thoroughfare, Locality or Secondary Locality
that exists.
Building Name

A building name may exist
 If there is a Building Name and also a numeric Sub-building Name, the Subbuilding Name and Building Name will appear together on the next line, as
described in the Sub-Building Name section above.
 If there is a Building Name and either no Sub-Building Name or a non-numeric
Sub-building Name, the Building Name will appear next on a separate line.
______________________________________________________________________________
Page 14 of 76
An Post / Ordnance Survey Ireland
Building Number

A Building Number may exist

Building Group
Primary Thoroughfare
Secondary Thoroughfare



GeoDirectory Technical Guide
If there is a Building Number, it will appear alongside the next one of Building
Group, Thoroughfare, Secondary Thoroughfare, Locality or Secondary Locality
that exists.
Either a building group or primary thoroughfare or both will be present for
urban addresses.
A primary thoroughfare may be present for rural addresses.
A secondary thoroughfare may be present
Each of these, if they exist, should appear on separate lines.
The only exception is that the first one that does exist should appear on the
same line as the building number, if that exists.
If Thoroughfare name is the same as Post Town name then it is not shown.
If Secondary Thoroughfare name is the same as Post Town name or
Thoroughfare name then it is not shown.
If a Primary Thoroughfare name does not exist, then the Locality name will
exist.
Locality
Secondary Locality


A Locality name may exist
A Secondary locality may exist
Each of these, if they exist, should appear next, on separate lines.
If Locality name is the same as the Secondary Thoroughfare name or
Thoroughfare name then it is not shown.
If Secondary Locality name is the same as any of Locality name, Secondary
Thoroughfare name or Thoroughfare name then it is not shown.
Post Town

A Post Town may exist.
If the Post Town does exist, It appears next, on a separate line.
County

A County may exist.
If county does exist, it should appear next, on a separate line.
______________________________________________________________________________
Page 15 of 76
An Post / Ordnance Survey Ireland
GeoDirectory Technical Guide
5.5 Examples of Addresses
Elements
Personal Name
Department
Organisation
Sub Building Name
Building Name
Building Number
Building Group Name
Primary Thoroughfare
Secondary Thoroughfare
Primary Locality
Secondary Locality
Post-town
County
Postal Address Line 1
Postal Address Line 2
Postal Address Line 3
Postal Address Line 4
Postal Address Line 5
Postal Address Line 6
Example 1
County is not required for Dublin numbered
districts.
FLAT 4
Flat numbers are stored in the ―Sub-Building
Name‖ field.
81
LEINSTER ROAD
DUBLIN 6
FLAT 4,
81 LEINSTER ROAD,
DUBLIN 6.
______________________________________________________________________________
Page 16 of 76
An Post / Ordnance Survey Ireland
Elements
Personal Name
Department
Organisation
Sub Building Name
Building Name
Building Number
Building Group Name
Primary Thoroughfare
Secondary Thoroughfare
Primary Locality
Secondary Locality
Post-town
County
Postal Address Line 1
Postal Address Line 2
Postal Address Line 3
Postal Address Line 4
Postal Address Line 5
Postal Address Line 6
GeoDirectory Technical Guide
Example 2
A primary locality of ―Ringsend‖ is
required to distinguish between
Pembroke Cottages in Ringsend
and Pembroke Cottages in
Donnybrook, both in Dublin 4.
20
PEMBROKE COTTAGES
RINGSEND
DUBLIN 4
20 PEMBROKE COTTAGES,
RINGSEND,
DUBLIN 4.
______________________________________________________________________________
Page 17 of 76
An Post / Ordnance Survey Ireland
Elements
Personal Name
Department
Organisation
Sub Building Name
Building Name
Building Number
Building Group Name
Primary Thoroughfare
Secondary Thoroughfare
Primary Locality
Secondary Locality
Post-town
County
Postal Address Line 1
Postal Address Line 2
Postal Address Line 3
Postal Address Line 4
Postal Address Line 5
Postal Address Line 6
GeoDirectory Technical Guide
Example 3
Clonskeagh Terrace is a group of houses which
has a name. However it is not a thoroughfare.
55
CLONSKEAGH TERRACE
CLONSKEAGH ROAD
It is therefore classified as a building group on
Clonskeagh Road thoroughfare. The building
group‘s thoroughfare name is marked as
―postally required‖.
DUBLIN 6
55 CLONSKEAGH TERRACE,
CLONSKEAGH ROAD,
DUBLIN 6.
______________________________________________________________________________
Page 18 of 76
An Post / Ordnance Survey Ireland
Elements
Personal Name
Department
Organisation
Sub Building Name
Building Name
Building Number
Building Group Name
Primary Thoroughfare
Secondary Thoroughfare
Primary Locality
Secondary Locality
Post-town
County
Postal Address Line 1
Postal Address Line 2
Postal Address Line 3
Postal Address Line 4
Postal Address Line 5
Postal Address Line 6
GeoDirectory Technical Guide
Example 4
BLOOMFIELD HOUSE
Bloomfield House (Building Name) is in
townland Bloomfield (Primary Locality) but
a secondary locality of Ballyhooly is
postally required. Also in this example the
Post Town is not required as the
POST_TOWN_REQUIRED flag on
Bloomfield is set to ‗N‘
BLOOMFIELD
BALLYHOOLY
CORK
BLOOMFIELD HOUSE,
BLOOMFIELD,
BALLYHOOLY,
CO. CORK.
______________________________________________________________________________
Page 19 of 76
An Post / Ordnance Survey Ireland
6.
GeoDirectory Technical Guide
GEODIRECTORY DATABASE SCHEMAS
Within An Post and OSi the GeoDirectory data is stored in a relational database (Oracle). This
section describes the structure of this database.
Every table except the address modelling group tables has a unique id as a primary key. For these tables
the BUILDING_ID and the ADDRESS_POINT_ID together form the primary key.
6.1 Data diagram
The data diagram for the database is shown on the next page.
______________________________________________________________________________
Page 20 of 76
Page 21 of 76
Page 22 of 76
An Post / Ordnance Survey Ireland
GeoDirectory Technical Guide
6.2 Table Descriptions
This section describes each of the tables in the GeoDirectory product. A full description of every column can
be found in Appendix F of this document.
Table Name
ADDITIONAL_FEATURES
Description
The ADDITIONAL_FEATURES table holds spatial data about features that
are not building. We intend to include datasets, captured at the point level,
which will enhance the usage of GeoDirectory in a wider context. An
example would be Bus stops.
This table is a work in progress and will be populated over time.
ADDITIONAL_FEATURE_TYPES
This table holds the classification for ADDITIONAL_FEATURES.
ADDRESS_POINTS
The ADDRESS_POINTS table is used to hold data on businesses or subunits within a building. Flat, apartment or unit numbers are held in the
SUB_BUILDING_NAME column. Business names are held in the
ORGANISATION and DEPARTMENT columns.
BUILDINGS
The BUILDINGS table holds a row for every building in the country that has a
postal address. It has grid co-ordinates EAST and NORTH in both Irish Grid
and Irish Transverse Mercator and now contains Latitude and Longitude
values. It has an associated unique id number, and holds the number of
commercial and residential delivery points for postal purposes.
If a building has 0 residential and 0 commercial delivery points, then this
building is one which does not receive any mail. For example, school
buildings other than the main building will not normally receive mail. The
BUILDING_USE will also be set to (U)nknown
The buildings table has (Y)es / (N)o flags to indicate whether or not it was
DERELICT, VACANT or UNDER_CONSTRUCTION on the date it was last
validated.
As no address database can be 100% correct, it may be necessary in the
future to correct errors by removing buildings from the database. Rather
than delete building records, however, an INVALID flag on the buildings table
will be set to ―Y‖. This will facilitate tracking a building‘s history, more so
than if a building was simply deleted from the database.
A BUILDING_USE column indicates whether this building is residential (R),
commercial (C), both residential & commercial (B) or unknown (U)
A building and its component sub-buildings are considered VERIFIED when
the building has been given a valid address by An Post and a valid EAST &
NORTH value by OSi. Only when these conditions are met will the
VERIFIED column flag be set to (Y)es.
A CREATE_DATE is now included on this table. This refers to the date that
the record was first created in the database.
BUILDING_DATUM
The BUILDING_DATUM holds a row for every building in the database. It
may contain information about the building including the height, number of
floors, BER and floor area.
There are two Heights stored, GROUND_HEIGHT_MSL (DTM) which is the
height of the ground above Mean Sea Level and the highest point of the
building called BUILDING_HEIGHT (DSM)
This table is a work in progress and will be populated over time.
______________________________________________________________________________
Page 23 of 76
An Post / Ordnance Survey Ireland
GeoDirectory Technical Guide
BUILDING_GROUPS
A Building Group is a named group of buildings on one thoroughfare. The
THORFARE_POSTALLY_REQ column is a Yes / No flag which indicates
whether or not to include the thoroughfare name when creating the
addresses for the building group. For example, Trinity College is a building
group which does not require a thoroughfare name as it is postally sufficient
to use Trinity College, Dublin 2.
BUILDING_GROUP_TYPES
Building groups can be one of a number of types, including Terrace,
Industrial Estate, Shopping Centre, Hospital, etc. For a complete listing
please see the Building_Group_Types Table
BUILDING_TYPES
The Type of Building e.g. Bungalow, Detached etc.
COUNTIES
One of the 26 counties.
DATA_SOURCES
Source of information, e.g. OSi or An Post.
DISTRICT_COURTS
This table holds a record for each District Court. By linking this table to the
EDS and then the BUILDINGS tables you can associate every address to its
District Court.
EDS
The Electoral Division associated with a building.
GEOGRAPHIC_FORMAT
Within the GeoDirectory database, addresses are stored in a normalised
database structure. The result is that the components that make up one
address are held in 1 of 7 tables.
There is a set of rules, described in section 3, as to how the various
components of the address should be brought together to form an address in
the standardised address model format.
The GEOGRAPHIC_FORMAT table holds an address for every valid
Address Point in the database that receives mail. For each address, the
rules have been applied and all the address elements have been brought
together into one table.
GEOGRAPHIC_FORMAT_CHANGES
This table has the same structure as the GEOGRAPHIC_FORMAT table, but
only contains addresses that have been changed, added or removed since
the last release of GeoDirectory.
Please note that this table is only populated with selected products.
IRISH_GEOGRAPHIC_FORMAT
The IRISH_GROGRAPHIC_FORMAT table holds the Irish translations of the
Names within the database. The same rules apply when creating this table
as when creating the GEOGRAPHIC_FORMAT table except we extract the
names from the IRISH_NAME fields within the relevant tables. As we are
building the Irish version, some of the translations will not be present and in
these cases the English name is used.
IRISH_GEOGRAPHIC_FORMAT_CHA
NGES
This table has the same structure as the IRISH_GEOGRAPHIC_FORMAT
table, but only contains addresses that have changed, added or removed
since the last release of GeoDirectory.
Please note that this table is only supplied with selected products.
IRISH_OFFICIAL_POSTAL_ADDRESS
The IRISH_OFFICIAL_POSTAL_ADDRESS table holds the Irish translations
of the Names within the database. The same rules apply when creating this
table as when creating the OFFICIAL_POSTAL_ADDRESS table except we
extract the names from the IRISH_NAME fields within the relevant tables. As
we are building the Irish version, some of the translations will not be present
and in these cases the English name is used.
LOCALITIES
There are a number of uses for the locality table in GeoDirectory including
1. To make thoroughfares unique as discussed above.
2. Industrial Estates which contain named thoroughfares are held as
localities.
3. The Primary Locality for a Rural Address.
4. The Secondary Locality for a Rural Address
LOCALITY_TYPES
GeoDirectory currently contains six locality types, ―INDUSTRIAL ESTATE‖,
―URBAN TOWNLAND‖,‖HOUSING ESTATE‖, ‖VILLAGE‖, ‖PRIMARY
RURAL LOCALITY‖, ‖SECONDARY RURAL LOCALITY‖. Every locality has
an associated locality type.
______________________________________________________________________________
Page 24 of 76
An Post / Ordnance Survey Ireland
GeoDirectory Technical Guide
LOCAL_AUTHORITIES
The name of one of the 34 Local Authority associated with the Building
NACE_CODES
NACE Code is a pan-European classification system which groups
organisations according to their business activities. This table lists all the
codes used by GeoDirectory.
OFFICIAL_POSTAL_ADDRESS
Within the GeoDirectory database, addresses are stored in a normalised
database structure. The result is that the components that make up one
address are held in 1 of 7 tables.
There is a set of rules, described in section 3, as to how the various
components of the address should be brought together to form an address in
the standardised address model format.
The OFFICIAL_POSTAL_ADDRESS table holds an address for every valid
Address Point in the database that receives mail. For each address, the
rules have been applied and all the address elements have been brought
together into one table.
POST_TOWNS
Name of a town designated by An Post as a Post Town or a Dublin postal
district.
POSTAIMS_PRESORT_61
Postaim is An Post‘s bulk addressed publicity post service. A Postaim code
is associated with each building and is used for pre-sorting Postaim material.
This is the 61 level for both Postaim and Presort products.
POSTAIMS_PRESORT_152
A pre-sort code is a code used by An Post in sorting mail. It will be used by
GeoDirectory customers who pre-sort mail before handing it to An Post. This
is the 152 level for both Postaim and Presort products.
PUBLICITY_POST_ZONES
The Publicity Post Zone associated with the Building.
SMALL_AREAS
The Small Areas associated with a building.
THOROUGHFARES
The thoroughfare or street on which a building is located. If two
thoroughfares with the same name exist in the same post-town, then a
secondary thoroughfare or a locality is associated with it, to make it unique.
TLANDS
The Townland associated with a building.
TOWNS
The Town associated with a Thoroughfare
VALUATION_OFFICES
The Valuation Office code and other relevant information from them
associated with the building. (Table not populated yet)
6.3 Updates & Deletions
When a new row is inserted or a row is updated in any way, the CHANGED_DATE column is updated to the
current date and time.
Rows may be deleted from the BUILDINGS, ADDRESS_POINTS or THOROUGHFARES tables to allow for
redundant data to be removed, but not without consulting our customers. Normally the INVALID column is
set to a value of ―Y‖, so that GeoDirectory customers will be explicitly shown that a building which was valid
has now been made invalid. Please note that Invalid records are not maintained and so should be excluded
from any query or reports run against the database.
______________________________________________________________________________
Page 25 of 76
An Post / Ordnance Survey Ireland
7.
GeoDirectory Technical Guide
GEODIRECTORY PRODUCTS
7.1 Product Portfolio
There are six GeoDirectory products as shown in the following table:





GeoForecaster
GeoNewbuild





GeoBusiness





GeoAddress
GeoBusiness
Locator
Residential Addresses
Business Addresses
Geo-codes
Boundaries
Business Names
GeoAddress
Locator
Product Components















7.2 Detailed Product Descriptions
The following table shows which database tables and columns are included in each GeoDirectory product. A
full description of every column can be found in Appendix F of this document.
FEATURE_ID
FEATURE_TYPE_ID
LATITUDE
LONGITUDE
EAST
NORTH
ITM_EAST
ITM_NORTH
NAME
ADDITIONAL_FEATURE_TYPES
FEATURE_TYPE_ID
FEATURE_TYPE
ADDRESS_POINTS
ADDRESS_POINT_ID
BUILDING_ID
SUB_BUILDING_NAME
ORGANISATION
DEPARTMENT
INVALID
VACANT
CHANGED_DATE
INCLUDE_ORG_NAME
NACE_CODE_ID
PHONE_NUMBER













































GeoForecaster



























GeoNewbuild

GeoBusiness
ADDITIONAL_FEATURES
GeoAddress
Column Name
GeoBusiness Locator
Table Name
GeoAddress Locator
Note: If the tick is in red then you must order this data along with the Product. This extra data is supplied at
an additional cost.





















































































______________________________________________________________________________
Page 26 of 76
BUILDING_ID
GROUND_HEIGHT_MSL
BUILDING_HEIGHT
FLOORS
BUILDING_ENERGY_RATING
BUILDING_AREA
CHANGED_DATE
BUILDING_GROUPS
GROUP_ID
GROUP_TYPE_ID
THORFARE_ID
NAME
THORFARE_POSTALLY_REQ
CHANGED_DATE
IRISH_NAME
IRISH_VERIFICATION
BUILDING_GROUP_TYPES
GROUP_TYPE_ID
NAME













































































































































































GeoForecaster
BUILDING_DATUM
























GeoNewbuild
BUILDING_ID
GROUP_ID
THORFARE_ID
POST_TOWN_ID
DATA_SRC_ID
CHANGED_DATE
POSTAIM_PRESORT_61
PRESORT_PRESORT_152
ED_ID
NAME
NO
BUILDING_USE
DERELICT
VACANT
INVALID
UNDER_CONSTRUCTION
RESIDENTIAL_DELIVERY_POINTS
COMMERCIAL_DELIVERY_POINTS
COUNTY_ID
TLAND_ID
EAST
NORTH
LOCALITY_ID
SECONDARY_LOCALITY_ID
VERIFIED
ITM_EAST
ITM_NORTH
QUALITY_CONTROL
PPZ_ID
HOLIDAY_HOME
DEMOLISHED
CREATE_DATE
BUILDING_TYPE_ID
LATITUDE
LONGITUDE
BUILDING_NUMBER_ALPHA
BUILDING_NUMBER_NUMERIC
LA_ID
VO_ID
LOCALITY_POSTALLY_REQ
SMALL_AREA_ID
GeoBusiness
BUILDINGS
GeoAddress
Column Name
GeoBusiness Locator
Table Name
GeoDirectory Technical Guide
GeoAddress Locator
An Post / Ordnance Survey Ireland




















































































































































































______________________________________________________________________________
Page 27 of 76











COUNTIES
COUNTY_ID
NAME
IRISH_NAME
IRISH_VERIFICATION

DATA_SRC_ID
NAME
DISTRICT_COURTS




















DATA_SOURCES
CS_ID
NAME
SCHEDULE1_REF
SCHEDULE2_REF
DISTRICT_COURT_AREA
SITTING_TIMES
EDS
ED_ID
COUNTY_ID
CHANGED_DATE
NAME
ED_UID
CS_ID
CSO_ED_ID


GEOGRAPHIC_FORMAT
BUILDING_ID
ADDRESS_POINT_ID
PERSONAL_NAME
ORGANISATION_NAME
DEPARTMENT
SUB_BUILDING_NAME
BUILDING_NAME
BUILDING_NUMBER
BUILDING_GROUP_NAME
THOROUGHFARE
SECONDARY_THOROUGHFARE
LOCALITY
SECONDARY_LOCALITY
POST_TOWN
COUNTY
ADDR_LINE_1
ADDR_LINE_2
ADDR_LINE_3
ADDR_LINE_4
ADDR_LINE_5
ADDR_LINE_6
ADDR_LINE_7
ADDR_LINE_8
ADDR_LINE_9
ADDR_LINE_10
ADDRESS_REFERENCE












































































































































































GeoForecaster




BUILDING_TYPE_ID
NAME
CODE
GeoNewbuild




BUILDING_TYPES
GeoBusiness
GeoAddress
Column Name
GeoBusiness Locator
Table Name
GeoDirectory Technical Guide
GeoAddress Locator
An Post / Ordnance Survey Ireland





























































































































______________________________________________________________________________
Page 28 of 76
GeoBusiness
GeoNewbuild
GeoForecaster
GEOGRAPHIC_FORMAT_CHANGES
GeoAddress
Column Name
GeoBusiness Locator
Table Name
GeoDirectory Technical Guide
GeoAddress Locator
An Post / Ordnance Survey Ireland

































BUILDING_ID
ADDRESS_POINT_ID
PERSONAL_NAME
ORGANISATION_NAME
DEPARTMENT
SUB_BUILDING_NAME
BUILDING_NAME
BUILDING_NUMBER
BUILDING_GROUP_NAME
THOROUGHFARE
SECONDARY_THOROUGHFARE
LOCALITY
SECONDARY_LOCALITY
POST_TOWN
COUNTY
ADDR_LINE_1
ADDR_LINE_2
ADDR_LINE_3
ADDR_LINE_4
ADDR_LINE_5
ADDR_LINE_6
ADDR_LINE_7
ADDR_LINE_8
ADDR_LINE_9
ADDR_LINE_10
ADDRESS_REFERENCE
CHANGED_TYPE



IRISH_ GEOGRAPHIC_FORMAT
BUILDING_ID
ADDRESS_POINT_ID
PERSONAL_NAME
ORGANISATION_NAME
DEPARTMENT
SUB_BUILDING_NAME
BUILDING_NAME
BUILDING_NUMBER
BUILDING_GROUP_NAME
THOROUGHFARE
SECONDARY_THOROUGHFARE
LOCALITY
SECONDARY_LOCALITY
POST_TOWN
COUNTY
ADDR_LINE_1
ADDR_LINE_2
ADDR_LINE_3
ADDR_LINE_4
ADDR_LINE_5
ADDR_LINE_6
ADDR_LINE_7
ADDR_LINE_8
ADDR_LINE_9
ADDR_LINE_10
ADDRESS_REFERENCE



































































































































































































































______________________________________________________________________________
Page 29 of 76
GeoNewbuild
GeoForecaster
IRISH_ GEOGRAPHIC_FORMAT
_CHANGE
GeoBusiness
Column Name
GeoAddress
Table Name
GeoBusiness Locator
GeoDirectory Technical Guide
GeoAddress Locator
An Post / Ordnance Survey Ireland

































BUILDING_ID
ADDRESS_POINT_ID
PERSONAL_NAME
ORGANISATION_NAME
DEPARTMENT
SUB_BUILDING_NAME
BUILDING_NAME
BUILDING_NUMBER
BUILDING_GROUP_NAME
THOROUGHFARE
SECONDARY_THOROUGHFARE
LOCALITY
SECONDARY_LOCALITY
POST_TOWN
COUNTY
ADDR_LINE_1
ADDR_LINE_2
ADDR_LINE_3
ADDR_LINE_4
ADDR_LINE_5
ADDR_LINE_6
ADDR_LINE_7
ADDR_LINE_8
ADDR_LINE_9
ADDR_LINE_10
ADDRESS_REFERENCE
CHANGED_TYPE


IRISH_ OFFICIAL_POSTAL_ADDRESS




























BUILDING_ID
ADDRESS_POINT_ID
PERSONAL_NAME
ORGANISATION_NAME
DEPARTMENT
SUB_BUILDING_NAME
BUILDING_NAME
BUILDING_NUMBER
BUILDING_GROUP_NAME
THOROUGHFARE
SECONDARY_THOROUGHFARE
LOCALITY
SECONDARY_LOCALITY
POST_TOWN
COUNTY
ADDR_LINE_1
ADDR_LINE_2
ADDR_LINE_3
ADDR_LINE_4
ADDR_LINE_5
ADDR_LINE_6
ADDR_LINE_7
ADDR_LINE_8
ADDR_LINE_9
ADDR_LINE_10
ADDRESS_REFERENCE


LOCAL_AUTHORITIES
LA_ID
NAME























































































































































































































______________________________________________________________________________
Page 30 of 76
GeoAddress
GeoBusiness
GeoNewbuild
GeoForecaster
Column Name
GeoBusiness Locator
Table Name
GeoDirectory Technical Guide
GeoAddress Locator
An Post / Ordnance Survey Ireland








































































LOCALITIES
LOCALITY_ID
LOCALITY_TYPE_ID
COUNTY_ID
NAME
CHANGED_DATE
SECONDARY_LOCALITY_ID
IRISH_NAME
IRISH_VERIFICATION
POST_TOWN_REQUIRED
POST_TOWN_REQUIRED_AP

LOCALITY_TYPES



BUILDING_ID
ADDRESS_POINT_ID
PERSONAL_NAME
ORGANISATION_NAME
DEPARTMENT
SUB_BUILDING_NAME
BUILDING_NAME
BUILDING_NUMBER
BUILDING_GROUP_NAME
THOROUGHFARE
SECONDARY_THOROUGHFARE
LOCALITY
SECONDARY_LOCALITY
POST_TOWN
COUNTY
ADDR_LINE_1
ADDR_LINE_2
ADDR_LINE_3
ADDR_LINE_4
ADDR_LINE_5
ADDR_LINE_6
ADDR_LINE_7
ADDR_LINE_8
ADDR_LINE_9
ADDR_LINE_10
ADDRESS_REFERENCE


















































































POST_TOWN_ID
COUNTY_ID
NAME
IRISH_NAME
IRISH_VERIFICATION












LOCALITY_TYPE_ID
NAME
NACE_CODES
NACE_CODE_ID
CATEGORY
NACE_CODE
OFFICIAL_POSTAL_ADDRESS
POST_TOWNS
POSTAIM_PRESORT_61
POSTAIM_PRESORT_61
NAME
POSTAIM_PRESORT_152
POSTAIM_PRESORT_152
NAME


























































































































































































______________________________________________________________________________
Page 31 of 76
SMALL_AREA_ID
COUNTY_ID
SMALL_AREA_REF
CHANGED_DATE
THOROUGHFARES
THORFARE_ID
CHANGED_DATE
THORFARE_NAME
QUALIFIER
MIN_X
MIN_Y
MAX_X
MAX_Y
ITM_MIN_X
ITM_MIN_Y
ITM_MAX_X
ITM_MAX_Y
NAME
GEOGRAPHIC
DESCRIPTOR
SECONDARY_THORFARE_ID
INVALID
IRISH_NAME
TOWN_ID
IRISH_VERIFICATION
TLANDS
TLAND_ID
COUNTY_ID
CHANGED_DATE
NAME
NAT_TNL_ID
TOWNS
TOWN_ID
NAME
COUNTY_ID
IRISH_NAME
IRISH_VERIFICATION
VALUATION_OFFICES
VO_ID
VO_CODE
RATEABLE_VALUE
VO_DATE
GeoForecaster
SMALL_AREAS
GeoNewbuild
PPZ_ID
NAME
GeoBusiness
PUBLICITY_POST_ZONES
GeoAddress
Column Name
GeoBusiness Locator
Table Name
GeoDirectory Technical Guide
GeoAddress Locator
An Post / Ordnance Survey Ireland
























































































































































































































































































______________________________________________________________________________
Page 32 of 76
An Post / Ordnance Survey Ireland
GeoDirectory Technical Guide
7.3 Sub-sets of Data
GeoDirectory holds approx. 1.89 million buildings and is growing daily. This equates to 2.2 million addresses
and these addresses can be ordered by sub-set.
7.3.1 Sub-sets by Product
While the ―GeoAddress Locator‖, ―GeoAddress‖, GeoNewbuild‖, ‖GeoForecaster‖ products contain
all available addresses, the ―GeoBusiness Locator‖ and ―GeoBusiness‖ products only contain
addresses which have businesses associated with them. Please see section 5 for the full list of
attributes supplied with each product.
7.3.2 Sub-sets by Customer Request
GeoDirectory customers can request sub-sets of addresses in the following categories
•
•
•
•
•
•
•
•
•
One, more or all counties
One, more or all towns / cities
One, more or all Dublin numbered districts
One, more or all Local Authorities
One, more or all Electoral Divisions
One, more or all Townlands
Point and Radius
NACE Code by County or all Counties
o
NACE Code is a pan-European classification system which groups organisations according to their
business activities. It assigns a unique 5 or 6 digit code to each industry sector; for example, C.10.52
is the MANUFACTURE OF ICE CREAM.
Publicity Post Zone
o
"Publicity Post is the delivery of UNADDRESSED mail targeted at a specific area rather than a specific
person with delivery zones all over the country. You simply pick the zone or zones that cover the area
that you have targeted and your communication is delivered with the ordinary post, unaddressed.
Whether you want to reach every house in your local area or every house in the country, Publicity Post
can do it"
Each of these criteria can be further restricted by the customer requesting an upper limit on the
number of addresses to include. The customer can also request urban or rural or both addresses
where relevant i.e. Counties and Local Authorities.
Examples include:
•
•
•
•
•
•
•
Galway, Mayo, Sligo
Dublin County
50K addresses in Dublin City
2.5K addresses in Dublin 2 and 3.5K addresses in Dublin 4
Cork city and Kilkenny City
Carlow Co. Council and Kilkenny Co. Council
News Agency Activities in County Kildare (NACE Code extract)
When a customer requests a sub-set of addresses, all tables in the data set will be similarly
restricted, e.g. the THOROUGHFARES table will only contain thoroughfares for buildings which are
in the BUILDINGS table. All other thoroughfares will be excluded.
______________________________________________________________________________
Page 33 of 76
An Post / Ordnance Survey Ireland
8.
GeoDirectory Technical Guide
DATA FORMATS
8.1 Product Data Formats
GeoDirectory data is currently available in four data formats, as shown in the table below.
For each data format, the files are zipped into one self-extracting .EXE file. To unzip the files run the .EXE
executable.
File Type
Oracle 10g Export
MS Access 2007
Comma Separated Values
XML Format
Unzipped
File
Extensions
Number of
Unzipped
Files
.DMP
.MDB
.CSV
.XML
1
1
24
24
Zipped file name
ORACLE.EXE
ACCESS07.EXE
CSV.EXE
XML.EXE
Each ZIP file is password protected
•
•
•
The Password is Organisation specific.
The Password it will be re-generated every 6 Months.
Receive the password by letter two weeks before the CD arrives.
All data formats are available, but Customers are encouraged to specify their preferred option when ordering
GeoDirectory products.
8.1.1 CSV File
There is one .CSV file for each table of data.
The first row in the .CSV file contains column names, not data. A comma is used as the field
delimiter and a double quote i.e. ―is used as the text qualifier. An empty or null alphabetic or
alphanumeric value is represented by ―‖. An empty or null numeric or date value is represented by a
blank. Dates in the CSV files are of the form DD/MM/YYYY.
An example CSV file is shown below.
―COL_1_NUMBER1‖,‖COL_2_NUMBER2‖,‖COL_3_CHARACTER‖,‖COL_4_DATE‖
1,,‖ABC‖,12/05/1999
2,,‖ABC‖,
3,,‖‖,12/05/1999
4,,‖‖,
5,999999.999,‖ABC‖,12/05/1999
,,‖ABC‖,12/05/1999
,,‖ABC‖,
,,‖‖,12/05/1999
,,‖‖,
The CSV file names and layouts can be seen on the next page.
______________________________________________________________________________
Page 34 of 76
An Post / Ordnance Survey Ireland
GeoDirectory Technical Guide
8.1.2 CSV File Layouts
File Name
Associated Table Name
Position
Column Name
Primary
Key
ADDFEAT.CSV
ADDITIONAL_FEATURES
1
2
3
4
5
6
7
8
9
FEATURE_ID
FEATURE_TYPE_ID
LATITUDE
LONGITUDE
EAST
NORTH
ITM_EAST
ITM_NORTH
NAME

ADDPOINT.CSV
ADDRESS_POINTS
1
2
3
4
5
6
7
8
9
10
11
ADDRESS_POINT_ID
BUILDING_ID
CHANGED_DATE
SUB_BUILDING_NAME
ORGANISATION
DEPARTMENT
INVALID
VACANT
INCLUDE_ORG_NAME
NACE_CODE_ID
PHONE_NUMBER

AFTYPES.CSV
ADDITIONAL_FEATURE_TYPES
1
2
FEATURE_TYPE_ID
FEATURE_TYPE

B_DATUM
BUILDING_DATUM
1
2
3
4
5
6
7
BUILDING_ID
GROUND_HEIGHT_MSL
BUILDING_HEIGHT
FLOORS
BUILDING_ENERGY_RATING
BUILDING_AREA
CHANGED_DATE

BUILDING.CSV
BUILDINGS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
BUILDING_ID
GROUP_ID
THORFARE_ID
POST_TOWN_ID
DATA_SRC_ID
CHANGED_DATE
POSTAIM_PRESORT_61
POSTAIM_PRESORT_152
ED_ID
NAME
NO
BUILDING_USE
DERELICT
VACANT
INVALID
UNDER_CONSTRUCTION
RESIDENTIAL_DELIVERY_POINTS
COMMERCIAL_DELIVERY_POINTS
COUNTY_ID
TLAND_ID
EAST
NORTH
LOCALITY_ID
SECONDARY_LOCALITY_ID
VERIFIED
ITM_EAST
ITM_NORTH
QUALITY_CONTROL
PPZ_ID
HOLIDAY_HOME
DEMOLISHED
CREATE_DATE
BUILDING_TYPE_ID
LATITUDE
LONGITUDE
BUILDING_NUMBER_NUMERIC
BUILDING_NUMBER_ALPHA
LA_ID
VO_ID
LOCALITY_POSTALLY_REQ
SMALL_AREA_ID

______________________________________________________________________________
Page 35 of 76



An Post / Ordnance Survey Ireland
File Name
Associated Table Name
GeoDirectory Technical Guide
Position
Column Name
Primary
Key
BTYPE.CSV
BUILDING_TYPES
1
2
3
BUILDING_TYPE_ID
NAME
CODE

COUNTY.CSV
COUNTIES
1
2
3
4
COUNTY_ID
NAME
IRISH_NAME
IRISH_VERIFICATION

DATASRC.CSV
DATA_SOURCES
1
2
DATA_SRC_ID
NAME

DISTC.CSV
DISTRICT_COURTS
1
2
3
4
5
6
CS_ID
NAME
SCHEDULE1_REF
SCHEDULE2_REF
DISTRICT_COURT_AREA
SITTING_TIMES






ED.CSV
EDS
1
2
3
4
5
6
7
ED_ID
COUNTY_ID
CHANGED_DATE
NAME
ED_UID
CS_ID
CSO_ED_ID

GF.CSV
GEOGRAPHIC_FORMAT
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
BUILDING_ID
ADDRESS_POINT_ID
PERSONAL_NAME
ORGANISATION_NAME
DEPARTMENT
SUB_BUILDING_NAME
BUILDING_NAME
BUILDING_NUMBER
BUILDING_GROUP_NAME
THOROUGHFARE
SECONDARY_THOROUGHFARE
LOCALITY
SECONDARY_LOCALITY
POST_TOWN
COUNTY
ADDR_LINE_1
ADDR_LINE_2
ADDR_LINE_3
ADDR_LINE_4
ADDR_LINE_5
ADDR_LINE_6
ADDR_LINE_7
ADDR_LINE_8
ADDR_LINE_9
ADDR_LINE_10
ADDRESS_REFERENCE


______________________________________________________________________________
Page 36 of 76
An Post / Ordnance Survey Ireland
File Name
GFC.CSV
Associated Table Name
GEOGRAPHIC_FORMAT
_CHANGE
GeoDirectory Technical Guide
Position
Column Name
Primary
Key
1
BUILDING_ID

2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
ADDRESS_POINT_ID
PERSONAL_NAME
ORGANISATION_NAME
DEPARTMENT
SUB_BUILDING_NAME
BUILDING_NAME
BUILDING_NUMBER
BUILDING_GROUP_NAME
THOROUGHFARE
SECONDARY_THOROUGHFARE
LOCALITY
SECONDARY_LOCALITY
POST_TOWN
COUNTY
ADDR_LINE_1
ADDR_LINE_2
ADDR_LINE_3
ADDR_LINE_4
ADDR_LINE_5
ADDR_LINE_6
ADDR_LINE_7
ADDR_LINE_8
ADDR_LINE_9
ADDR_LINE_10
ADDRESS_REFERENCE
CHANGED_TYPE

GRPTYPE.CSV
BUILDING_GROUP_TYPES
1
2
GROUP_TYPE_ID
NAME

GROUP.CSV
BUILDING_GROUPS
1
2
3
4
5
6
7
8
GROUP_ID
GROUP_TYPE_ID
THORFARE_ID
NAME
IRISH_NAME
THORFARE_POSTALLY_REQ
CHANGED_DATE
IRISH_VERIFICATION

IGF.CSV
IRISH_ GEOGRAPHIC_FORMAT
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
BUILDING_ID
ADDRESS_POINT_ID
PERSONAL_NAME
ORGANISATION_NAME
DEPARTMENT
SUB_BUILDING_NAME
BUILDING_NAME
BUILDING_NUMBER
BUILDING_GROUP_NAME
THOROUGHFARE
SECONDARY_THOROUGHFARE
LOCALITY
SECONDARY_LOCALITY
POST_TOWN
COUNTY
ADDR_LINE_1
ADDR_LINE_2
ADDR_LINE_3
ADDR_LINE_4
ADDR_LINE_5
ADDR_LINE_6
ADDR_LINE_7
ADDR_LINE_8
ADDR_LINE_9
ADDR_LINE_10
ADDRESS_REFERENCE


______________________________________________________________________________
Page 37 of 76
An Post / Ordnance Survey Ireland
File Name
IGFC.CSV
IOPA.CSV
Associated Table Name
IRISH_
GEOGRAPHIC_FORMAT
_CHANGE
IRISH_OFFICIAL_POSTAL_AD
DRESS
GeoDirectory Technical Guide
Position
Column Name
Primary
Key
1
BUILDING_ID

2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
ADDRESS_POINT_ID
PERSONAL_NAME
ORGANISATION_NAME
DEPARTMENT
SUB_BUILDING_NAME
BUILDING_NAME
BUILDING_NUMBER
BUILDING_GROUP_NAME
THOROUGHFARE
SECONDARY_THOROUGHFARE
LOCALITY
SECONDARY_LOCALITY
POST_TOWN
COUNTY
ADDR_LINE_1
ADDR_LINE_2
ADDR_LINE_3
ADDR_LINE_4
ADDR_LINE_5
ADDR_LINE_6
ADDR_LINE_7
ADDR_LINE_8
ADDR_LINE_9
ADDR_LINE_10
ADDRESS_REFERENCE
CHANGED_TYPE

1
BUILDING_ID

2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
ADDRESS_POINT_ID
PERSONAL_NAME
ORGANISATION_NAME
DEPARTMENT
SUB_BUILDING_NAME
BUILDING_NAME
BUILDING_NUMBER
BUILDING_GROUP_NAME
THOROUGHFARE
SECONDARY_THOROUGHFARE
LOCALITY
SECONDARY_LOCALITY
POST_TOWN
COUNTY
ADDR_LINE_1
ADDR_LINE_2
ADDR_LINE_3
ADDR_LINE_4
ADDR_LINE_5
ADDR_LINE_6
ADDR_LINE_7
ADDR_LINE_8
ADDR_LINE_9
ADDR_LINE_10
ADDRESS_REFERENCE


LA.CSV
LOCAL_AUTHORITIES
1
2
LA_ID
NAME
LOCALITY.CSV
LOCALITIES
1
2
3
4
5
6
7
8
9
10
COUNTY_ID
LOCALITY_ID
LOCALITY_TYPE_ID
NAME
CHANGED_DATE
SECONDARY_LOCALITY_ID
IRISH_NAME
IRISH_VERIFICATION
POST_TOWN_REQUIRED
POST_TOWN_REQUIRED_AP

______________________________________________________________________________
Page 38 of 76
An Post / Ordnance Survey Ireland
File Name
Associated Table Name
GeoDirectory Technical Guide
Position
Column Name
Primary
Key
LOCTYPE.CSV
LOCALITY_TYPES
1
2
LOCALITY_TYPE_ID
NAME

NACECODE.CSV
NACE_CODES
1
2
3
NACE_CODE_ID
CATEGORY
NACE_CODE

OPA.CSV
OFFICIAL_POSTAL_ADDRESS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
BUILDING_ID
ADDRESS_POINT_ID
PERSONAL_NAME
ORGANISATION_NAME
DEPARTMENT
SUB_BUILDING_NAME
BUILDING_NAME
BUILDING_NUMBER
BUILDING_GROUP_NAME
THOROUGHFARE
SECONDARY_THOROUGHFARE
LOCALITY
SECONDARY_LOCALITY
POST_TOWN
COUNTY
ADDR_LINE_1
ADDR_LINE_2
ADDR_LINE_3
ADDR_LINE_4
ADDR_LINE_5
ADDR_LINE_6
ADDR_LINE_7
ADDR_LINE_8
ADDR_LINE_9
ADDR_LINE_10
ADDRESS_REFERENCE


POSTTOWN.CSV
POST_TOWNS
1
2
3
4
5
POST_TOWN_ID
COUNTY_ID
NAME
IRISH_NAME
IRISH_VERIFICATION

PP_61.CSV
POSTAIM_PRESORT_61
1
2
POSTAIM_PRESORT_61
NAME

PP_152.CSV
POSTAIM_PRESORT_152
1
2
POSTAIM_PRESORT_152
NAME

PPZ_ZONE.CSV
PUBLICITY_POST_ZONES
1
2
PPZ_ID
NAME

SA.CSV
SMALL_AREAS
1
2
3
4
SMALL_AREA_ID
COUNTY_ID
SMALL_AREA_REF
CHANGED_DATE

THORFARE.CSV
THOROUGHFARES
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
THORFARE_ID
CHANGED_DATE
THORFARE_NAME
QUALIFIER
MIN_X
MIN_Y
MAX_X
MAX_Y
ITM_MIN_X
ITM_MIN_Y
ITM_MAX_X
ITM_MAX_Y
NAME
GEOGRAPHIC
DESCRIPTOR
SECONDARY_THORFARE_ID
INVALID
IRISH_NAME
TOWN_ID
IRISH_VERIFICATION

______________________________________________________________________________
Page 39 of 76
An Post / Ordnance Survey Ireland
File Name
Associated Table Name
GeoDirectory Technical Guide
Position
Column Name
Primary
Key
TLAND.CSV
TLANDS
1
2
3
4
5
TLAND_ID
COUNTY_ID
CHANGED_DATE
NAME
NAT_TNL_ID

TOWN.CSV
TOWNS
1
2
3
4
5
TOWN_ID
NAME
COUNTY_ID
IRISH_NAME
IRISH_VERIFICATION

VO.CSV
VALUATION_OFFICES
1
2
3
4
VO_ID
VO_CODE
RATEABLE_VALUE
VO_DATE

______________________________________________________________________________
Page 40 of 76
An Post / Ordnance Survey Ireland
GeoDirectory Technical Guide
8.1.3 XML File Layouts
Extensible Markup Language (XML) is a method for putting structured data into a text file that
follows standard guidelines and can be read by a variety of applications. This document is encoded
in ISO-646 (US- ASCII). The character set of XML is Unicode per RIG 3. Characters outside the USASCII range are represented with character entities in decimal notation. There is one .XML file for
each of the 17 tables of data and this is a sample from the Buildings Table
<?xml version="1.0" ?>
- <ROOTDOC>
- <BUILDINGS>
<building_id>16005888</building_id>
<group_id />
<thorfare_id>16006180</thorfare_id>
<post_town_id>152</post_town_id>
<data_src_id>1</data_src_id>
<changed_date>17/02/2005</changed_date>
<postaim_presort_61>441</postaim_presort_61>
<postaim_presort_152>441</postaim_presort_152>
<ed_id>177058</ed_id>
<name>ELVARD</name>
<no>13</no>
<building_use>R</building_use>
<derelict>N</derelict>
<vacant>N</vacant>
<invalid>N</invalid>
<under_construction>N</under_construction>
<residential_delivery_points>1</residential_delivery_points>
<commercial_delivery_points>0</commercial_delivery_points>
<county_id>18</county_id>
<tland_id>170381</tland_id>
<east>267499.771</east>
<north>334864.024</north>
<locality_id />
<secondary_locality_id />
<verified>Y</verified>
<itm_east>667436.623</itm_east>
<itm_north>834868.837</itm_north>
<quality_control />
<ppz_id>3745</ppz_id>
<holiday_home />
<demolished />
<create_date>15/10/1998</create_date>
<building_type_id></ building_type_id>
<latitude></latitude>
<Longitude></longitude>
<building_number_numeric></building_number_numeric>
<building_number_alpha></building_number_alpha>
<la_id />
<vo_id />
<locality_postally_req>N</locality_postally_req>
<small_area_id>7297</small_area_id>
</BUILDINGS>
Special Characters
Non US-ASCII characters used are the ISO-1252 / ISO-8859-1 code points for diacritics. Irish
characters are stored in the files in the following manor:
Á
Ú
8.2
&#193
&#218
É
&
&#201
&amp
Í
&#205
Ó
&#211
Character Formats
All GeoDirectory data is stored in upper case only.
______________________________________________________________________________
Page 41 of 76
An Post / Ordnance Survey Ireland
9.
GeoDirectory Technical Guide
INTEGRATING THE GEODIRECTORY DATABASE
GeoDirectory data is an asset which your company is considering or has invested in. Managing the
integration and uploading the releases will have a cost associated with it, but providing high quality
up-to-date Addresses will generate benefits including cost savings and enhance the decision
making process. While GeoDirectory itself does not support the integration of the GeoDirectory
database within your organisation, it is recommended that consideration is given to this process. In
this regard any of the GeoDirectory Value Added Resellers should be in a position to propose
solutions.
9.1 Integrating databases without GeoDirectory
(n-1) n / 2 Links
= Exponential
Complexity
9.2 Integrating databases with GeoDirectory
GeoDirectory
n Links
= Linear
Complexity
______________________________________________________________________________
Page 42 of 76
An Post / Ordnance Survey Ireland
10.
GeoDirectory Technical Guide
HOW TO MANAGE GEODIRECTORY RELEASES
GeoDirectory updates are released six times a year with each customer receiving a completely
refreshed supply of the area they ordered. We recommend that a strategy be developed within the
organisation on how to handle these releases. We have some examples below, but this in by no
means all the options, and it is up to each organisation to develop the solution that suits them best.
10.1 Update your database with the changes since the last release.
GeoDirectory
April
GeoDirectory
January
Each record is time stamped when any field on the record is updated. With this method you can
extract only the records that have a time stamp after the last release date and import these.
______________________________________________________________________________
Page 43 of 76
An Post / Ordnance Survey Ireland
GeoDirectory Technical Guide
10.2 Replace with New Release
With this method you drop your existing version of the database and replace with the new release.
GeoDirectory
January
GeoDirectory
April
______________________________________________________________________________
Page 44 of 76
An Post / Ordnance Survey Ireland
10.3
GeoDirectory Technical Guide
Where to store additional in-house addresses
10.3.1 In transactional database
Advantages
•
Easy Implement
Disadvantages
•
GeoDirectory
New addresses
not shared
•
Addresses
Duplicated with
different IDs
•
10.3.2
More matching
required when
address appears
in GeoDirectory
In GeoDirectory
Advantages
GeoDirectory
•
•
•
Addresses Shared
Single ID for address
Less matching
required later
Disadvantages
•
Cannot discard
GeoDirectory for new
release
______________________________________________________________________________
Page 45 of 76
An Post / Ordnance Survey Ireland
10.3.3
GeoDirectory Technical Guide
Address Repository
Advantages
•
GeoDirector
y
•
Can discard &
replace
GeoDirectory
Appears as single
address database
Disadvantages
•
Complex
Implementation
______________________________________________________________________________
Page 46 of 76
An Post / Ordnance Survey Ireland
GeoDirectory Technical Guide
11.
INTEGRATING GEODIRECTORY WITH GIS
11.1
ARCGIS
In ArcGIS use the add table button
access / CSV file:
to open the add table window and browse to your GeoDirectory
Open the file, click on the BUILDINGS table and click Add
______________________________________________________________________________
Page 47 of 76
An Post / Ordnance Survey Ireland
GeoDirectory Technical Guide
Right click on the Buildings table in the ArcMap Table of Contents and choose Display XY Data… from the
menu
Populate the dialog box as follows choosing East and North for the X Field and Y Field respectively. Edit the
Coordinate System of Input Coordinates, browse to Irish National Grid.prg and click add. Click OK to save.
The Points will now load in the Map Window.
To save this table as a shape point file right click on the BUILDINGS Event layer, choose Data > Export Data
______________________________________________________________________________
Page 48 of 76
An Post / Ordnance Survey Ireland
GeoDirectory Technical Guide
Click on the browse button, choose a location and a name for the shape file and click Save
______________________________________________________________________________
Page 49 of 76
An Post / Ordnance Survey Ireland
GeoDirectory Technical Guide
To view attribution for BUILDINGS from other access tables a join can be establish between the BUILDINGS
shape file and other GeoDirectory tables e.g. ADDRESS MODELLING Tables for address line data.
To do so open additional tables using the add table button
and choose Joins and Relates > Join
. Right click on the BUILDINGS shape file
Within the Join Data dialog box choose tables and join types, in this example BUILDINGS is joined to
ADDRESS MODEL based on BUILDING_ID keeping matching records only.
______________________________________________________________________________
Page 50 of 76
An Post / Ordnance Survey Ireland
11.2
GeoDirectory Technical Guide
MAPINFO
1) Open Mapinfo and go to file open
2) Select Microsoft Access Database (*.mdb)
3) Double click on the GeoDirectory Access database
______________________________________________________________________________
Page 51 of 76
An Post / Ordnance Survey Ireland
GeoDirectory Technical Guide
4) Select the BUILDINGS Table
5) BUILDINGS table opens within Mapinfo
6) To create the building point locations. Go to Table, Create Points
______________________________________________________________________________
Page 52 of 76
An Post / Ordnance Survey Ireland
GeoDirectory Technical Guide
7) When this dialogue box appears. Set your Easting and Northing to the correct
fields and your projection to Irish National Grid
8) Once these parameters are set click ok and the GeoDirectory Points will appear
in your map window. This will take some time for the full GeoDirectory data.
______________________________________________________________________________
Page 53 of 76
An Post / Ordnance Survey Ireland
GeoDirectory Technical Guide
APPENDIX A – LEGAL STATEMENT
GeoDirectory Legal Statement
The GeoDirectory and the Documentation contain confidential information of An Post GeoDirectory
Limited and Ordnance Survey Ireland and all copyright, trade marks and other intellectual property
rights including all rights provided for by the Database Directive in the GeoDirectory and the
Documentation are the exclusive property of An Post GeoDirectory Limited and Ordnance Survey
Ireland.
Use of the GeoDirectory and the Documentation is subject to a separate Licence Agreement and
such use must be in accordance with its terms and conditions.
Notwithstanding the Documentation being the exclusive property of An Post GeoDirectory Limited
it may be freely distributed though it may not be altered or amended in any way and it may not be
supplied for value except by An Post GeoDirectory Limited.
While An Post GeoDirectory Limited employees and agents are authorised to provide assistance
by means of the Help Desk facility, any such assistance shall be solely at your risk and An Post
GeoDirectory Limited will not be liable for any loss or damage suffered by you arising as a result.
______________________________________________________________________________
Page 54 of 76
An Post / Ordnance Survey Ireland
GeoDirectory Technical Guide
APPENDIX B – IRISH GRID
Geographical co-ordinates on the Irish Grid are based on a false origin 200 kilometres west and 250
o
o
kilometres south of Latitude 8 00‘ 00‖ W and Longitude 53 30‘ 00‖ N, based on the Transverse Mercator
Map Projection on the Airy Modified ellipsoid.
Each address is given a geo-code (distance in Eastings and Northings) from the false origin to three decimal
places. These can be stripped back to the nearest metre if necessary i.e.
East
North
314654.256
239127.462
to
East
North
314654
239127
OVERVIEW
National Reference System
Reference Ellipsoid
Geodetic Datum
Irish Grid
Airy Modified
1965 Datum
Vertical Datum
Malin Head
Map Projection
Transverse Mercator
Measurement Unit
International metre
DEFINITIONS AND PARAMETERS
Airy Modified Ellipsoid
All geographical co-ordinates, on which the Irish Grid is based, are expressed in terms of the Airy Modified
Ellipsoid, as fixed to the 1965 Datum. This ellipsoid is based on the Airy Ellipsoid, defined in feet of bar O 1,
2
with a semi-major axis (a) of 20,923,713 feet, and eccentricity squared (e ) of 0.00667054015. With
1
metrication a conversion factor was agreed between feet of bar O to the International metre of
0.3048007491. The Airy Ellipsoid was reduced by 35 parts per million (ppm) for the Irish reference ellipsoid,
resulting in the following, standard parameters:
semi-major axis (a) :
2
Eccentricity (e ) :
6 377 340.189 m
0.006 670 540 15
The 1965 Geodetic Datum
The Geodetic Datum of the Irish Grid is a derived one based on the positions of ten OSNI primary
triangulation stations to their 1952 adjustment values, and the positions of three OSi primary triangulation
stations fixed to their 1965 adjustment values. The 1965 adjustment was a best mean fit to the positions of
the Northern Ireland Primary points as adjusted in 1952. The 1952 adjustment was based on the Principal
Triangulation positions of three points in Northern Ireland: Knocklayd, Trostan and Divis.
1
a bar of standard length kept by OSi
______________________________________________________________________________
Page 55 of 76
An Post / Ordnance Survey Ireland
GeoDirectory Technical Guide
APPENDIX C – ITM CO-ORDINATES
ITM is a newly derived GPS compatible mapping projection that is associated with the ETRS89 and the
GRS80 ellipsoid. The true origin and central meridian defined in the Irish Grid is maintained, thus distributing
the distortions due to the projection evenly.
Consideration was given to the introduction of a scale factor of unity on the central meridian. However, using
a scale of 0.99982 results in two standard parallels, and the magnitude and effects of scale change are
minimised.
The position of the false origin is moved to a point 600,000m west and 750,000m south of the true origin.
This results in grid co-ordinates that are significantly different from IG, but does not introduce additional
distortion or complexity. The magnitude of the shift ensures that IG co-ordinates plotted on the ITM
projection do not fall on Ireland or Northern Ireland, and vice versa.
Technical Information
Reference Ellipsoid:
GRS80
Central Meridian:
8° West
Scale on CM:
0.999 820
True Origin:
False Origin (metres):
Latitude (Φ)
53° 30' North
Longitude (λ)
8° 00‘ West
600 000 W
750 000 S
______________________________________________________________________________
Page 56 of 76
An Post / Ordnance Survey Ireland
GeoDirectory Technical Guide
APPENDIX D – ETRS89 CO-ORDINATED
ETRS89 geographical co-ordinates on which ITM are based are expressed in terms of the GRS80 Ellipsoid
semi-major axis (a) :
2
Eccentricity (e ) :
6378137.000m
0.00669438002290
______________________________________________________________________________
Page 57 of 76
An Post / Ordnance Survey Ireland
GeoDirectory Technical Guide
APPENDIX E – BOUNDARY DATA SETS
County
The Republic of Ireland is divided into 26 Counties. These counties are sub-national divisions used
for the purposes of administrative, geographical and political demarcation. Every building in
GeoDirectory is assigned to a County and the County is normally used as part of the postal address
with some exceptions e.g. Dublin numbered districts where the county is not used and the County
Towns where no County prefix is required.
Barony
GeoDirectory does not contain the Barony boundary set.
Electoral Division (ED‟s)
Each County in the Republic of Ireland is divided into Electoral Divisions. In 1994 the District
Electoral Divisions and Wards were renamed Electoral Divisions and the boundaries and names
remaining unchanged. The GeoDirectory database identifies the Electoral Division into which each
building falls, which is especially useful for market and demographic analysis. There are a small
number of EDs which are not unique within a County e.g. there are two CLONCURRY in County
Kildare and these require the Barony to make them unique. There are 3,441 Electoral Divisions in
the database
Townland
A Townland is a small geographical division of land used in Ireland and is a sub-division of the
Electoral Division. The townland system is of Gaelic origin—most townlands are believed to predate the Norman invasion and most have names derived from the Irish language. Each Building in
GeoDirectory outside the 5 cities Dublin, Cork, Limerick, Galway and Waterford is assigned to a
Townland. Townlands may not be unique within the County and require the Electoral Division to
make then unique. There are 50,732 Townlands in the database.
Small Areas
Smalls Areas are a national boundaries dataset which nests into the Electoral Districts boundaries,
with each small area having an average of 95 dwellings. They are a sub-division of the Electoral
Divisions and maybe in future be the legally defined administrative areas in the State for which
Statistics (SAPS) are published by the Central Statistics Office. There are 18,489 Small Areas in the
database.
Notes:a.
A small number of buildings are between the High Water Mark and the Low Water Mark and
hence have no boundary information assigned.
b.
If the verify flag on the Buildings table is set to ‗N‘ then these buildings may not have a
boundary assigned as the geocoding process was not completed before the current release of
GeoDirectory.
______________________________________________________________________________
Page 58 of 76
An Post / Ordnance Survey Ireland
GeoDirectory Technical Guide
APPENDIX F – DATABASE COLUMN DESCRIPTIONS
Table and
Column Name
ADDITIONAL_FEATURES
Column Size and
Column Type
Column Description
FEATURE_ID
FEATURE_TYPE_ID
LATITUDE
LONGITUDE
EAST
NORTH
ITM_EAST
ITM_NORTH
NAME
Character(30)
Number(10)
Character(100)
Character(100)
Number
Number
Number
Number
Character(60)
Unique identification number for the Feature
Populated from the Additional Features Table
Geocode expressed as a Latitude
Geocode expressed as a Longitude
Geographical co-ordinate indicating distance in Eastings
Geographical co-ordinate indicating distance in Northings
ITM Geographical co-ordinate indicating distance in Eastings
ITM Geographical co-ordinate indicating distance in Northings
The Name of the Feature
Number(10)
Character(60)
Unique identification number for the Feature type
ADDRESS_POINT_ID
BUILDING_ID
CHANGED_DATE
SUB_BUILDING_NAME
ORGANISATION
DEPARTMENT
INVALID
VACANT
INCLUDE_ORG_NAME
Number(10)
Number(10)
Date
Character(60)
Character(60)
Character(60)
Character(1)
Character(1)
Character(1)
NACE_CODE_ID
PHONE_NUMBER
Number(10)
Character(15)
Unique 8 digit identification number for the sub-building
Populated from BUILDINGS table
Date when this row was last changed
Name of the sub-building e.g. Flat 1, Unit 1, etc.
Organisation name
Department name
A Yes/No field, indicating whether or not the sub-building is invalid.
A Yes/No field, indicating whether or not the sub-building is vacant
A Yes/No field, indicating whether or not to include the Organisation Name when constructing the address in the
address model table. In some cases the organisation name does not form part of the Postal Address
Populated from the NACE_CODES table
The phone number of the Organisation if populated
Number(10)
Number
Number
Number
Character(2)
Number
Date
Populated from BUILDINGS table
The DTM or ground height
The DSM or height of the building
The number of floors in the building
The building energy rating
The floor area of the building
Date when this row was last changed
ADDITIONAL_FEATURE_TYPES
FEATURE_TYPE_ID
FEATURE_TYPE
The name of the Feature type
ADDRESS_POINTS TABLE
BUILDING_DATUM
BUILDING_ID
GROUND_HEIGHT_MSL
BUILDING_HEIGHT
FLOORS
BUILDING_ENERGY_RATING
BUILDING_AREA
CHANGED_DATE
__________________________________________________________________________________________________________________________
Page 59 of 76
An Post / Ordnance Survey Ireland
GeoDirectory Technical Guide
Table and
Column Name
BUILDING_GROUPS TABLE
Column Size and
Column Type
Column Description
GROUP_ID
GROUP_TYPE_ID
THORFARE_ID
NAME
IRISH_NAME
THORFARE_POSTALLY_REQ
CHANGED_DATE
IRISH_VERIFICATION
Number(10)
Number(10)
Number(10)
Character(60)
Character(60)
Character(1)
Date
Character(1)
Unique identification number for the building group.
Populated from BUILDING_GROUP_TYPES table.
Populated from THOROUGHFARES table.
Name of the building group.
The Irish Name for the Building Group
A Yes/No field, indicating whether or not a thoroughfare is required postally.
Date when this row was last changed.
A Yes/No field, indicating whether or not the Irish translation was verified by the Placenames Branch of the
Department of Community, Rural and Gaeltacht Affairs.
Number(10)
Character(40)
Unique identification number for the type of building group.
Name of the type of building group (Hospital, Terrace, Court, Shopping Centre, etc.).
Number(10)
Character(20)
Character(2)
Unique identification number for the Building Type
The name of the Building Type
The Code or the abbreviation of the Name
BUILDING_GROUP_TYPES TABLE
GROUP_TYPE_ID
NAME
BUILDING_TYPES
BUILDING_TYPE_ID
NAME
CODE
__________________________________________________________________________________________________________________________
Page 60 of 76
An Post / Ordnance Survey Ireland
GeoDirectory Technical Guide
BUILDINGS TABLE
BUILDING_ID
GROUP_ID
THORFARE_ID
POST_TOWN_ID
DATA_SRC_ID
CHANGED_DATE
POSTAIM_PRESORT_61
POSTAIM_PRESORT_152
ED_ID
NAME
NO
BUILDING_USE
DERELICT
VACANT
INVALID
UNDER_CONSTRUCTION
RESIDENTIAL_DELIVERY_POINTS
COMMERCIAL_DELIVERY_POINTS
COUNTY_ID
TLAND_ID
EAST
NORTH
LOCALITY_ID
SECONDARY_LOCALITY_ID
VERIFIED
Number(10)
Number(10)
Number(10)
Number(10)
Number(10)
Date
Number(10)
Number(10)
Number(10)
Character(60)
Character(40)
Character(1)
Character(1)
Character(1)
Character(1)
Character(1)
Number(10)
Number(10)
Number(10)
Number(10)
Number(10,3)
Number(10,3)
Number(10)
Number(10)
Character(1)
ITM_EAST
ITM_NORTH
QUALITY_CONTROL
Number
Number
Character(15)
Unique 8 digit identification number for the building.
Populated from BUILDING_GROUPS table.
Populated from THOROUGHFARES table.
Populated from POST_TOWNS table.
Populated from DATA_SOURCES table.
Date when this row was last changed.
Populated from POSTAIM_PRESORT_61 table.
Populated from POSTAIM_PRESORT_152 table.
Populated from EDS table.
Name of the building.
The building number.
R- Residential, C- Commercial, B- Both or U- Unknown
A Yes/No field, indicating whether or not the building is derelict.
A Yes/No field, indicating whether or not the building is vacant.
A Yes/No field, indicating whether or not the building is invalid.
A Yes/No field, indicating whether or not the building is under construction.
The total number of residential delivery points in the building.
The total number of commercial delivery points in the building.
Populated from COUNTIES table.
Populated from TLANDS table.
Geographical co-ordinate indicating distance in Eastings.
Geographical co-ordinate indicating distance in Northings.
Populated from LOCALITIES table.
Not Populated
A Yes/No field, indicating whether or not the building has been validated by An Post and assigned a valid Geocode
by OSi.
ITM Geographical co-ordinate indicating distance in Eastings.
ITM Geographical co-ordinate indicating distance in Northings.
This is a text string indicating the source and accuracy of the geocoding:
Number(10)
Character(1)
Character(1)
Date
Number(10)
Character(100)
Character(100)
Number(10)
Character(20)
Number(10)
Number(10)
Character(1)
Number(10)
MAP
- Where the footprint of the building is located on the large scale map.
ORTHO
- Where the footprint of the building is located on the Ortho Photograph
AN POST - Where An Post believes the location of the building is on the Map.
Populated from PUBLICITY_POST_ZONES table.
A Yes/No field, indicating whether or not the building is a holiday home.
A Yes/No field, indicating whether or not the building is demolished.
Date when the record was first inserted into the Database
Populated from BUILDING_TYPES table.
Geocode of the Building expressed as a Latitude
Geocode of the Building expressed as a Longitude
The split Building Number (excluding Number ranges) populated with the numeric value
The split Building Number (excluding Number ranges) populated with the alpha value
Populated from the LOCAL_AUTHORITIES table
Not Populated
A Yes/No field, indicating whether or not the Locality is to be included in the address.
Populated from the SMALL_AREAS table
PPZ_ID
HOLIDAY_HOME
DEMOLISHED
CREATE_DATE
BUILDING_TYPE_ID
LATITUDE
LONGITUDE
BUILDING_NUMBER_NUMERIC
BUILDING_NUMBER_ALPHA
LA_ID
VO_ID
LOCALITY_POSTALLY_REQ
SMALL_AREA_ID
__________________________________________________________________________________________________________________________
Page 61 of 76
An Post / Ordnance Survey Ireland
GeoDirectory Technical Guide
Table and
Column Names
COUNTIES TABLE
Column Size and
Column Type
Column Description
COUNTY_ID
NAME
IRISH_NAME
IRISH_VERIFICATION
Number(10)
Character(40)
Character(20)
Character(1)
Unique identification number for the county
Name of the county
Irish Name for the Counties
A Yes/No field, indicating whether or not the Irish translation was verified by the Placenames Branch of the
Department of Community, Rural and Gaeltacht Affairs
Number(10)
Character(40)
Unique identification number for the data source
Name of the data source (An Post Inspection, OSi Mapping, etc.).
Number(10)
Character(60)
Number(10)
Number(10)
Character(60)
Character(250)
Unique identification number for the District Court
The Name of the District Court
The reference number for the First Schedule
The reference number for the Second Schedule
The District Court District
The date and time of Court sittings
Number(10)
Number(10)
Date
Character(40)
Number(10)
Number(10)
Number(10)
Unique identification number for the Electoral Division associated with the building
Populated from COUNTIES table
Date when this row was last changed
Name of the Electoral Division
An Id number for ED‘s agreed between various government bodies
Populated from DISTRICT_COURTS table
Central Statistics Office Electoral Division code
DATA_SOURCES TABLE
DATA_SRC_ID
NAME
DISTRICT_COURTS
CS_ID
NAME
SCHEDULE1_REF
SCHEDULE2_REF
DISTRICT_COURT_AREA
SITTING_TIMES
EDS TABLE
ED_ID
COUNTY_ID
CHANGED_DATE
NAME
ED_UID
CS_ID
CSO_ED_ID
__________________________________________________________________________________________________________________________
Page 62 of 76
An Post / Ordnance Survey Ireland
GeoDirectory Technical Guide
Table and
Column Names
GEOGRAPHIC_FORMAT
Column Size and
Column Type

BUILDING_ID
ADDRESS_POINT_ID
PERSONAL_NAME
ORGANISATION_NAME
DEPARTMENT
SUB_BUILDING_NAME
BUILDING_NAME
BUILDING_NUMBER
BUILDING_GROUP_NAME
THOROUGHFARE
SECONDARY_THOROUGHFARE
LOCALITY
SECONDARY_LOCALITY
POST_TOWN
COUNTY
ADDR_LINE_1
Number (10)
Number (10)
Character(40)
Character(60)
Character(60)
Character(60)
Character(60)
Character(40)
Character(60)
Character(40)
Character(40)
Character(40)
Character(40)
Character(40)
Character(40)
Character(200)
ADDR_LINE_2
ADDR_LINE_3
ADDR_LINE_4
ADDR_LINE_5
ADDR_LINE_6
ADDR_LINE_7
ADDR_LINE_8
ADDR_LINE_9
ADDR_LINE_10
ADDRESS_REFERENCE
Character(200)
Character(200)
Character(200)
Character(200)
Character(200)
Character(200)
Character(200)
Character(200)
Character(200)
Character(16)
Column Description

Populated from BUILDINGS table.
Populated from ADDRESS_POINTS table.
Not populated.
Populated from ADDRESS_POINTS table.
Populated from ADDRESS_POINTS table.
Populated from ADDRESS_POINTS table.
Populated from BUILDINGS table.
Populated from BUILDINGS table.
Populated from BUILDING_GROUPS table.
Populated from THOROUGHFARES table.
Populated from THOROUGHFARES table.
Populated from LOCALITIES table.
Populated from LOCALITIES table.
Populated from POST_TOWNS table.
Populated from COUNTIES table.
Fields ADDR_LINE_1 .. ADDR_LINE_10 are populated based on the values in fields ORGANISATION_NAME
..COUNTY.
Combination of the Building_id and the Address_Point_ID. If the Address_Point_ID is null then the
Address_Reference is padded with zeros
__________________________________________________________________________________________________________________________
Page 63 of 76
An Post / Ordnance Survey Ireland
Table Name
And
Column Name
GEOGRAPHIC_FORMAT_CHANGES
TABLE
GeoDirectory Technical Guide
Column Size and
Column Type
Column Description


BUILDING_ID
ADDRESS_POINT_ID
PERSONAL_NAME
ORGANISATION_NAME
DEPARTMENT
SUB_BUILDING_NAME
BUILDING_NAME
BUILDING_NUMBER
BUILDING_GROUP_NAME
THOROUGHFARE
SECONDARY_THOROUGHFARE
LOCALITY
SECONDARY_LOCALITY
POST_TOWN
COUNTY
ADDR_LINE_1
Number (10)
Number (10)
Character(40)
Character(60)
Character(60)
Character(60)
Character(60)
Character(40)
Character(60)
Character(40)
Character(40)
Character(40)
Character(40)
Character(40)
Character(40)
Character(200)
Populated from BUILDINGS table.
Populated from ADDRESS_POINTS table.
Not populated.
Populated from ADDRESS_POINTS table.
Populated from ADDRESS_POINTS table.
Populated from ADDRESS_POINTS table.
Populated from BUILDINGS table.
Populated from BUILDINGS table.
Populated from BUILDING_GROUPS table.
Populated from THOROUGHFARES table.
Populated from THOROUGHFARES table.
Populated from LOCALITIES table.
Populated from LOCALITIES table.
Populated from POST_TOWNS table.
Populated from COUNTIES table.
Fields ADDR_LINE_1 .. ADDR_LINE_10 are populated based on the values in fields ORGANISATION_NAME ..
COUNTY.
ADDR_LINE_2
ADDR_LINE_3
ADDR_LINE_4
ADDR_LINE_5
ADDR_LINE_6
ADDR_LINE_7
ADDR_LINE_8
ADDR_LINE_9
ADDR_LINE_10
ADDRESS_REFERENCE
Character(200)
Character(200)
Character(200)
Character(200)
Character(200)
Character(200)
Character(200)
Character(200)
Character(200)
Character(16)
CHANGE_TYPE
Character(1)
Combination of the Building_id and the Address_Point_ID. If the Address_Point_ID is null then the
Address_Reference is padded with zeros
This indicates whether the record was Updated, Deleted or a new record since the last release.
(I)nserted
(U)pdated
(D)eleted
__________________________________________________________________________________________________________________________
Page 64 of 76
An Post / Ordnance Survey Ireland
GeoDirectory Technical Guide
Table And
Column Names
IRISH_GEOGRAPHIC_FORMAT TABLE
Column Size and
Column Type
BUILDING_ID
ADDRESS_POINT_ID
PERSONAL_NAME
ORGANISATION_NAME
DEPARTMENT
SUB_BUILDING_NAME
BUILDING_NAME
BUILDING_NUMBER
BUILDING_GROUP_NAME
THOROUGHFARE
SECONDARY_THOROUGHFARE
LOCALITY
SECONDARY_LOCALITY
POST_TOWN
COUNTY
ADDR_LINE_1
Number (10)
Number (10)
Character(40)
Character(60)
Character(60)
Character(60)
Character(60)
Character(40)
Character(60)
Character(40)
Character(40)
Character(40)
Character(40)
Character(40)
Character(40)
Character(200)
ADDR_LINE_2
ADDR_LINE_3
ADDR_LINE_4
ADDR_LINE_5
ADDR_LINE_6
ADDR_LINE_7
ADDR_LINE_8
ADDR_LINE_9
ADDR_LINE_10
ADDRESS_REFERENCE
Character(200)
Character(200)
Character(200)
Character(200)
Character(200)
Character(200)
Character(200)
Character(200)
Character(200)
Character(16)
Column Description
Populated from BUILDINGS table.
Populated from ADDRESS_POINTS table.
Not populated.
Populated from ADDRESS_POINTS table.
Populated from ADDRESS_POINTS table.
Populated from ADDRESS_POINTS table.
Populated from BUILDINGS table.
Populated from BUILDINGS table.
Populated from the ‗IRISH_NAME‘ field in the BUILDING_GROUPS table.
Populated from the ‗IRISH_NAME‘ field in the THOROUGHFARES table.
Populated from the ‗IRISH_NAME‘ field in the THOROUGHFARES table.
Populated from the ‗IRISH_NAME‘ field in the LOCALITIES table.
Populated from the ‗IRISH_NAME‘ field in the LOCALITIES table.
Populated from the ‗IRISH_NAME‘ field in the POST_TOWNS table.
Populated from the ‗IRISH_NAME‘ field in the COUNTIES table.
Fields ADDR_LINE_1 ... ADDR_LINE_10 are populated based on the values in fields ORGANISATION_NAME ...
COUNTY.
Combination of the Building_id and the Address_Point_ID. If the Address_Point_ID is null then the
Address_Reference is padded with zeros
__________________________________________________________________________________________________________________________
Page 65 of 76
An Post / Ordnance Survey Ireland
Table Name and
Column Names
GeoDirectory Technical Guide
Column Size
and
Column Type
Column Description
IRISH_GEOGRAPHIC_FORMAT_CHANGES
TABLE
BUILDING_ID
ADDRESS_POINT_ID
PERSONAL_NAME
ORGANISATION_NAME
DEPARTMENT
SUB_BUILDING_NAME
BUILDING_NAME
BUILDING_NUMBER
BUILDING_GROUP_NAME
THOROUGHFARE
SECONDARY_THOROUGHFARE
LOCALITY
SECONDARY_LOCALITY
POST_TOWN
COUNTY
ADDR_LINE_1
Number (10)
Number (10)
Character(40)
Character(60)
Character(60)
Character(60)
Character(60)
Character(40)
Character(60)
Character(40)
Character(40)
Character(40)
Character(40)
Character(40)
Character(40)
Character(200)
ADDR_LINE_2
ADDR_LINE_3
ADDR_LINE_4
ADDR_LINE_5
ADDR_LINE_6
ADDR_LINE_7
ADDR_LINE_8
ADDR_LINE_9
ADDR_LINE_10
ADDRESS_REFERENCE
Character(200)
Character(200)
Character(200)
Character(200)
Character(200)
Character(200)
Character(200)
Character(200)
Character(200)
Character(16)
CHANGE_TYPE
Character(1)
Populated from BUILDINGS table.
Populated from ADDRESS_POINTS table.
Not populated.
Populated from ADDRESS_POINTS table.
Populated from ADDRESS_POINTS table.
Populated from ADDRESS_POINTS table.
Populated from BUILDINGS table.
Populated from BUILDINGS table.
Populated from the ‗IRISH_NAME‘ field in the BUILDING_GROUPS table.
Populated from the ‗IRISH_NAME‘ field in the THOROUGHFARES table.
Populated from the ‗IRISH_NAME‘ field in the THOROUGHFARES table.
Populated from the ‗IRISH_NAME‘ field in the LOCALITIES table.
Populated from the ‗IRISH_NAME‘ field in the LOCALITIES table.
Populated from the ‗IRISH_NAME‘ field in the POST_TOWNS table.
Populated from the ‗IRISH_NAME‘ field in the COUNTIES table.
Fields ADDR_LINE_1 ... ADDR_LINE_10 are populated based on the values in fields ORGANISATION_NAME ...
COUNTY.
Combination of the Building_id and the Address_Point_ID. If the Address_Point_ID is null then the
Address_Reference is padded with zeros
This indicates whether the record was Updated, Deleted or a new record since the last release.
(I)nserted
(U)pdated
(D)eleted
__________________________________________________________________________________________________________________________
Page 66 of 76
An Post / Ordnance Survey Ireland
GeoDirectory Technical Guide
Table and
Column Names
IRISH_OFFICIAL_POSTAL_ADDRESS
TABLE
Column Size and
Column Type
BUILDING_ID
ADDRESS_POINT_ID
PERSONAL_NAME
ORGANISATION_NAME
DEPARTMENT
SUB_BUILDING_NAME
BUILDING_NAME
BUILDING_NUMBER
BUILDING_GROUP_NAME
THOROUGHFARE
SECONDARY_THOROUGHFARE
LOCALITY
SECONDARY_LOCALITY
POST_TOWN
COUNTY
ADDR_LINE_1
Number (10)
Number (10)
Character(40)
Character(60)
Character(60)
Character(60)
Character(60)
Character(40)
Character(60)
Character(40)
Character(40)
Character(40)
Character(40)
Character(40)
Character(40)
Character(200)
ADDR_LINE_2
ADDR_LINE_3
ADDR_LINE_4
ADDR_LINE_5
ADDR_LINE_6
ADDR_LINE_7
ADDR_LINE_8
ADDR_LINE_9
ADDR_LINE_10
ADDRESS_REFERENCE
Character(200)
Character(200)
Character(200)
Character(200)
Character(200)
Character(200)
Character(200)
Character(200)
Character(200)
Character(16)
Column Description
Populated from BUILDINGS table.
Populated from ADDRESS_POINTS table.
Not populated.
Populated from ADDRESS_POINTS table.
Populated from ADDRESS_POINTS table.
Populated from ADDRESS_POINTS table.
Populated from BUILDINGS table.
Populated from BUILDINGS table.
Populated from the ‗IRISH_NAME‘ field in the BUILDING_GROUPS table.
Populated from the ‗IRISH_NAME‘ field in the THOROUGHFARES table.
Populated from the ‗IRISH_NAME‘ field in the THOROUGHFARES table.
Populated from the ‗IRISH_NAME‘ field in the LOCALITIES table.
Populated from the ‗IRISH_NAME‘ field in the LOCALITIES table.
Populated from the ‗IRISH_NAME‘ field in the POST_TOWNS table.
Populated from the ‗IRISH_NAME‘ field in the COUNTIES table.
Fields ADDR_LINE_1 ... ADDR_LINE_10 are populated based on the values in fields ORGANISATION_NAME ...
COUNTY.
Combination of the Building_id and the Address_Point_ID. If the Address_Point_ID is null then the
Address_Reference is padded with zeros
LOCALITIES TABLE
COUNTY_ID
LOCALITY_ID
LOCALITY_TYPE_ID
NAME
CHANGED_DATE
SECONDARY_LOCALITY_ID
IRISH_NAME
IRISH_VERIFICATION
Number(10)
Number(10)
Number(10)
Character(40)
Date
Number(10)
Character(60)
Character(1)
POST_TOWN_REQUIRED
Character(1)
POST_TOWN_REQUIRED_AP
Character(1)
Populated from COUNTIES table.
Unique identification number for the locality of the building.
Populated from LOCALITY_TYPES table.
Name of the locality.
Date when this row was last changed.
Unique identification number for the Secondary Locality associated with the Primary Locality
Irish Name for the Locality
A Yes/No field, indicating whether or not the Irish translation was verified by the Placenames Branch of the
Department of Community, Rural and Gaeltacht Affairs.
A Yes/No field, indicating whether or not to include the Post Town as part of the GEOGRAPHIC_FORMAT
address.
A Yes/No field, indicating whether or not to include the Post Town as part of the OFFICIAL_POSTAL_ADDRESS
__________________________________________________________________________________________________________________________
Page 67 of 76
An Post / Ordnance Survey Ireland
GeoDirectory Technical Guide
Table and
Column Name
LOCAL_AUTHORITIES TABLE
Column Size and
Column Type
Column Description
LA_ID
NAME
Number (10)
Character(40)
Unique identification number for the Locality Authority
Name of the Local Authority
Number(10)
Character(40)
Unique identification number for the type of locality.
Name of the type of locality (Industrial Estate, Suburb etc.).
NACE_CODE_ID
CATEGORY
NACE_CODE
Number(10)
Character(200)
Character(10)
Unique identification number for the Organisation categories
The name of the category
The NACE code for the Category
OFFICIAL_POSTAL_ADDRESS TABLE


BUILDING_ID
ADDRESS_POINT_ID
PERSONAL_NAME
ORGANISATION_NAME
DEPARTMENT
SUB_BUILDING_NAME
BUILDING_NAME
BUILDING_NUMBER
BUILDING_GROUP_NAME
THOROUGHFARE
SECONDARY_THOROUGHFARE
LOCALITY
SECONDARY_LOCALITY
POST_TOWN
COUNTY
ADDR_LINE_1
Number (10)
Number (10)
Character(40)
Character(60)
Character(60)
Character(60)
Character(60)
Character(40)
Character(60)
Character(40)
Character(40)
Character(40)
Character(40)
Character(40)
Character(40)
Character(200)
Populated from BUILDINGS table.
Populated from ADDRESS_POINTS table.
Not populated.
Populated from ADDRESS_POINTS table.
Populated from ADDRESS_POINTS table.
Populated from ADDRESS_POINTS table.
Populated from BUILDINGS table.
Populated from BUILDINGS table.
Populated from BUILDING_GROUPS table.
Populated from THOROUGHFARES table.
Populated from THOROUGHFARES table.
Populated from LOCALITIES table.
Populated from LOCALITIES table.
Populated from POST_TOWNS table.
Populated from COUNTIES table.
Fields ADDR_LINE_1 .. ADDR_LINE_10 are populated based on the values in fields ORGANISATION_NAME
..COUNTY.
ADDR_LINE_2
ADDR_LINE_3
ADDR_LINE_4
ADDR_LINE_5
ADDR_LINE_6
ADDR_LINE_7
ADDR_LINE_8
ADDR_LINE_9
ADDR_LINE_10
ADDRESS_REFERENCE
Character(200)
Character(200)
Character(200)
Character(200)
Character(200)
Character(200)
Character(200)
Character(200)
Character(200)
Character(16)
LOCALITY_TYPES TABLE
LOCALITY_TYPE_ID
NAME
NACE_CODES TABLE
Combination of the Building_id and the Address_Point_ID. If the Address_Point_ID is null then the
Address_Reference is padded with zeros
__________________________________________________________________________________________________________________________
Page 68 of 76
An Post / Ordnance Survey Ireland
Table and
Column Names
POSTAIM_PRESORT_61 TABLE
POSTAIM_PRESORT_61
NAME
GeoDirectory Technical Guide
Column Size and
Column Type
Column Description
Number(10)
Character(100)
Unique identification number for the Postaim / Presort code associated with the building.
The Postaim / Presort code for the 61 level products.
Number(10)
Character(100)
Unique identification number for the Postaim / Presort code associated with the building.
The Postaim / Presort code for the 152 level products.
Number(10)
Number(10)
Character(40)
Character(40)
Character(1)
Unique identification number for the post town.
Populated from COUNTIES table.
Name of the post town.
Irish Name for the Post Town
A Yes/No field, indicating whether or not the Irish translation was verified by the Placenames Branch of the
Department of Community, Rural and Gaeltacht Affairs.
Number(10)
Character(60)
Unique identification number for the Publicity Post Zone
Name of the Publicity Post Zone
Number(10)
Number(10)
Character(65)
Date
Unique identification number for the SMALL AREA
Populated from COUNTIES table.
Name of the Small Area
Date when this row was last changed.
POSTAIM_PRESORT_152 TABLE
POSTAIM_PRESORT_152
NAME
POST_TOWNS TABLE
POST_TOWN_ID
COUNTY_ID
NAME
IRISH_NAME
IRISH_VERIFICATION
PUBLICITY_POST_ZONES TABLE
PPZ_ID
NAME
SMALL_AREAS TABLE
SMALL_AREA_ID
COUNTY_ID
SMALL_AREA_REF
CHANGED_DATE
__________________________________________________________________________________________________________________________
Page 69 of 76
An Post / Ordnance Survey Ireland
GeoDirectory Technical Guide
Table and
Column Names
THOROUGHFARES TABLE
Column Size and
Column Type
Column Description
THORFARE_ID
CHANGED_DATE
THORFARE_NAME
QUALIFIER
MIN_X
MIN_Y
MAX_X
MAX_Y
ITM_MIN_X
ITM_MIN_Y
ITM_MAX_X
ITM_MAX_Y
NAME
GEOGRAPHIC
DESCRIPTOR
SECONDARY_THORFARE_ID
INVALID
IRISH_NAME
TOWN_ID
IRISH_VERIFICATION
Number(10)
Date
Character(40)
Character(40)
Number(10,3)
Number(10,3)
Number(10,3)
Number(10,3)
Number
Number
Number
Number
Character(40)
Character(40)
Character(40)
Number(10)
Character(1)
Character(40)
Number(10)
Character(1)
Unique identification number for the thoroughfare.
Date when this row was last changed.
Name of the thoroughfare.
Thoroughfare qualifier (Upper, Lower, Middle, etc.).
Geographic starting east co-ordinate of the smallest rectangle that can be drawn around the thoroughfare.
Geographic starting north co-ordinate of the smallest rectangle that can be drawn around the thoroughfare.
Geographic ending east co-ordinate of the smallest rectangle that can be drawn around the thoroughfare.
Geographic ending north co-ordinate of the smallest rectangle that can be drawn around the thoroughfare.
Geographic starting ITM east co-ordinate of the smallest rectangle that can be drawn around the thoroughfare.
Geographic starting ITM north co-ordinate of the smallest rectangle that can be drawn around the thoroughfare.
Geographic ending ITM east co-ordinate of the smallest rectangle that can be drawn around the thoroughfare.
Geographic ending ITM north co-ordinate of the smallest rectangle that can be drawn around the thoroughfare.
Qualifier name.
Geographic location (East, West, North or South).
Descriptor (Road, Park, Street, etc.).
Populated from THOROUGHFARES table.
A Yes/No field, indicating whether or not the thoroughfare is invalid.
Irish Name for the Thoroughfare
The ID for the Town the thoroughfare is associated with.
A Yes/No field, indicating whether or not the Irish translation was verified by the Placenames Branch of the
Department of Community, Rural and Gaeltacht Affairs.
Number(10)
Number(10)
Date
Character(80)
Number(10)
Unique identification number for the townland.
Populated from COUNTIES table.
Date when this row was last changed.
Name of the townland.
An Id number for Townlands agreed between various government bodies.
Number(10)
Character(40)
Number(10)
Character(40)
Character(1)
Unique identification number for the Town.
Name of the Town
Populated from COUNTIES table.
Irish Name for the Town
A Yes/No field, indicating whether or not the Irish translation was verified by the Placenames Branch of the
Department of Community, Rural and Gaeltacht Affairs.
TLANDS TABLE
TLAND_ID
COUNTY_ID
CHANGED_DATE
NAME
NAT_TNL_ID
TOWNS TABLE
TOWN_ID
NAME
COUNTY_ID
IRISH_NAME
IRISH_VERIFICATION
VALUATION_OFFICES
VO_ID
VO_CODE
RATEABLE_VALUE
VO_DATE
(Table not populated)
Number(10)
Character(2)
Number(10,2)
Date
Unique Primary key
Date when this row was last changed
__________________________________________________________________________________________________________________________
Page 70 of 76
An Post / Ordnance Survey Ireland
GeoDirectory Technical Guide
APPENDIX G – HISTORY OF TECHNICAL CHANGES
March 2003
Impact
Column Name
Description
BUILDING_GROUPS table
New Field Added
IRISH_NAME
Character(60)
THOROUGHFARES Table
Four New Fields Added
ITM_MIN_X
NUMBER
ITM_MIN_Y
NUMBER
ITM_MAX_X
NUMBER
ITM_MAX_Y
NUMBER
BUILDINGS Table
A new building classification of ‗U‘ for
unknown.
July 2004
BUILDINGS table
Impact
New Field Added
July 2005
Impact
BUILDING_USE
Column Name
QUALITY_CONTROL
Column Name
Description
Character(15)
Description
ADDRESS_POINTS table
New Field Added
INCLUDE_ORG_NAME
Character(1)
BUILDINGS Table
New Field Added
CREATE_DATE
Date
BUILDING_GROUPS table
New Field Added
IRISH_NAME
Character(60)
IRISH_VERIFICATION
Character(1)
IRISH_NAME
Character(60)
IRISH_VERIFICATION
Character(1)
IRISH_NAME
Character(60)
IRISH_VERIFICATION
Character(1)
IRISH_NAME
Character(60)
IRISH_VERIFICATION
Character(1)
IRISH_NAME
Character(60)
IRISH_VERIFICATION
Character(1)
LOCALITIES table
TOWNS
POST_TOWNS
COUNTIES
IRISH_ADDRESS_MODEL
table
July 2007
New Field Added
New Field Added
New Field Added
New Field Added
New Table
Impact
Column Name
Description
BUILDINGS table
Extend the size of a Field
NAME
Character(60)
ADDRESS_POINTS table
Extend the size of a Field
SUB_BUILDING_NAME
Character(60)
DEPARTMENT
Character(60)
SUB_BUILDING_NAME
Character(60)
DEPARTMENT
Character(60)
BUILDIG_NAME
Character(60)
SUB_BUILDING_NAME
Character(60)
DEPARTMENT
Character(60)
BUILDING_NAME
Character(60)
ADDRESS_MODEL table
IRISH_ADDRESS_MODEL
table
Extend the size of a Field
Extend the size of a Field
_________________________________________________________________________________
Page 71 of 76
An Post / Ordnance Survey Ireland
April 2008
PUBLICITY_POST_ZONES
NACE CODES
GeoDirectory Technical Guide
Impact
Column Name
Description
New column on the BUILDINGS Table
PPZ_ID
NUMBER (10)
New Table called
PUBLICITY_POST_ZONES
PPZ_ID
NUMBER(10)
NAME
Character(60)
New Column on the ADDRESS_POINTS
table.
ORG_CAT_ID
NUMBER (10)
New Table called ORG_CATEGORIES
ORG_CAT_ID
NUMBER (10)
CATEGORY
Character(200)
NACE_CODE
Character(10)
HOLIDAY_HOMES
New column on the BUILDINGS Table
HOLIDAY_HOME
Character(1)
DEMOLISHED
New column on the BUILDINGS Table
called
DEMOLISHED
Character(1)
Irish & English Address
Model Tables
Extend the length of some Fields.
ADDR_LINE_1
ADDR_LINE_2
ADDR_LINE_3
ADDR_LINE_4
ADDR_LINE_5
ADDR_LINE_6
ADDR_LINE_7
ADDR_LINE_8
ADDR_LINE_9
ADDR_LINE_10
Character(200)
October 2008
Impact
Column Name
Description
Password on the ZIP files
You will need to know your password to
unzip the data files.
Building Types
New Field on the BUILDINGS Table.
BUILDING_TYPE_ID
NUMBER(10)
New Table Called BUILDING_TYPES
BUILDING_TYPE_ID
NUMBER(10)
NAME
Character(20)
CODE
Character(2)
ATOMIC_AREA
Character(20)
Small Area Boundary Set
(SABS)
New Field on the BUILDINGS Table.
July 2009
Post Town Required Flag.
When creating the address
from the normalised tables
you need to reference this
Y/N flag on the Localities
table (all except Secondary
Localities) to establish if the
Post Town is required as
part of the commonly used
postal address.
Remove Invalid Records
Impact
1.
New Rules when creating the
Address.
2.
New Field on the LOCALITIES
Table
Description
Character(1)
invalid records were removed from 3
tables:1.
2.
3.
BUILDINGS
ADDRESS_POINTS
THOROUGHFARES
1.
Now releasing the Oracle format in
10g.
Need to have 10g oracle to import
the data.
January 2010
Upgraded to Oracle 10G
Column Name
POST_TOWN_REQUIRED
Impact
2.
Column Name
Description
_________________________________________________________________________________
Page 72 of 76
An Post / Ordnance Survey Ireland
October 2010
GeoDirectory Technical Guide
Impact
Column Name
Description
Include the Latitude
& Longitude.
1.
Two new columns on the BUILDINGS table.
LATITUDE
LONGITUDE
Character(100)
Character(100)
Renamed the
column Atomic
Areas to SABS
(Small Area
Boundary Set)
1.
New Column name
SABS
Character(20)
Two New Tables
supplied
1.
Two new tables supplied with GeoDirectory products
called:
a.
ADDRESS_MODEL_CHANGES
b.
IRISH_ADDRESS_MODEL_CHANGES
Same as the Address_model
table.
New Column on the
ADDRESS_MODEL
Tables.
1.
New column on the Tables
a. ADDRESS_MODEL
b. ADDRESS_MODEL_CHANGES
c. IRISH_ADDRESS_MODEL
d. IRISH_ADDRESS_MODEL_CHANGES
ADDRESS_REFERENCE
Character(16)
Split the Building
Number into
Numeric and Alpha.
1.
Two new columns on the Buildings table.
BUILDING_NUMBER_ALPHA
BUILDING_NUMBER_NUMERIC
Character(20)
Number(10)
Updated the
Product range
1.
Two new products supplied by GeoDirectory.
a. GeoNewbuild
b. GeoForecaster
Same as the columns in
GeoAddress locator Product.
Updates to the
GeoAddress
product
1.
Data removed from this product.
BUILDING_USE
DERELICT
VACANT
HOLIDAY_HOME
BUILDING_TYPE_ID
SABS
BUILDINGS Table
All Columns
BUILDING_TYPES table
ORG_CAT_ID
ADDRESS_POINTS
All Columns
ORG_CATEGORIES
DERELICT
VACANT
HOLIDAY_HOME
BUILDING_TYPE_ID
SABS
Buildings Table
All Columns
BUILDING_TYPES table
Updates to the
GeoBusiness
product
Two new reports
included with the
Data set.
July 2011
1.
Data removed from this product.
1.
A new report called xxxx_Summary_Sheet.txt for all
customers to show the number of records in each
table.
2.
A new report called
xxxx_Summary_Address_Changes.txt for customers
of the GeoAddress Locator, GeoNewbuild and
GeoForecaster to show the number of new or
amended records in each table.
Impact
Text Files included within
the .EXE file.
Column Name
Description
New ER Diagram
1. New page inserted and page numbering changed.
Extra ER Diagram to
show the relationships
between the tables.
Integrating
GeoDirectory with
GIS
1. New section inserted and page numbering changed
New section to show
users how to integrate
GeoDirectory into GIS
Boundary
Descriptions
1. New appendix inserted and page numbering changed.
A description of the
Boundary information
found in the database.
_________________________________________________________________________________
Page 73 of 76
An Post / Ordnance Survey Ireland
March 2012
GeoDirectory will now be releases 6
times each year on a bi-monthly
base.
GeoDirectory Technical Guide
Impact
Column Name
1. Naming convention is now:
a.
b.
c.
d.
e.
f.
Description
The naming convention now
contains the letters for the two
Months data in the file. i.e. JF
includes data for January and
February. The last two digits
i.e. 12 is the year of release.
XXXXX_CSV_JF12.exe (released March)
XXXXX_CSV_MA12.exe (released May)
XXXXX_CSV_MJ12.exe (released July)
XXXXX_CSV_JA12.exe (released September)
XXXXX_CSV_SO12.exe (released November)
XXXXX_CSV_ND12.exe (released in January)
This convention will be the same for the
other formats
New Building type added
1. A new entry has been added to the
BUILDING_TYPES table called
―Temporary Dwelling‖
New entry in the
building_types table which
allows GeoDirectory classify
semi-permanent structures as
Temporary Dwellings.
Updated Access to 2007
1. The file format in Access will now be
supplied in Access 2007.
New name for the file will be
XXXXX_ACCESS07_JA12
Size of the Access file
1. If the Access file exceeds 1.75mb then it
will be split into 2 files.
Rename the table
ORG_CATEGORIES to
NACE_CODES
1. Table name is now NACE_CODES
Rename the column ORG_CAT_ID on
the ADDRESS_POINTS table to
NACE_CODE_ID
1.
New column on the
ADDRESS_MODEL_CHANGES table
The (E)xtra file contain:Irish_address_model
Irish_address_model_changes
Address_model_changes
tables. The rest of the tables
are in the file (M)ain file.
Renamed table to indicate that
GeoDirectory has adopted
NACE codes as its standard
for classifying Business.
NACE_CODE_ID
Renamed column to indicate
that GeoDirectory has adopted
NACE codes as its standard
for classifying Business.
1. This table now contains addresses that
have been amended, inserted or deleted
from the ADDRESS_MODEL table since
the last release. This action will be
indicated by I, U or D in the new column
CHANGE_TYPE.
CHANGE_TYPE
The values can be
(I)nserted
(U)pdated
(D)eleted
New column on the
IRISH_ADDRESS_MODEL_CHANGES
table
1.
This table now contains addresses that
have been amended, inserted or deleted
from the IRISH_ADDRESS_MODEL table
since the last release. This action will be
indicated by I, U or D in the new column
CHANGE_TYPE.
CHANGE_TYPE
The values can be
(I)nserted
(U)pdated
(D)eleted
Removed the column
“LOCALITY_ID” from the
Thoroughfares table.
1.
Column removed from the table.
Additional data – Local Authorities
1.
New column on the Buildings table
called LA_ID to indicate what Local
Authority the building is associated with.
2.
New table called
LOCAL_AUTHORITIES
1.
New column on the Buildings table
called VO_ID to indicate the Valuation
Office code.
2.
New table called
VALUATION_OFFICES
The ER diagram was updated to
reflect new tables, columns and
column name changes
1.
Diagram updated
New section added
1.
Pages renumbered
Additional data – Valuation Office
Column name is now NACE_CODE_ID
File Names
XXXXX_ACCESS_M_JA12
XXXXX_ACCESS_E_JA12
LOCALITY_ID
This column has not been
populated for some years so it
was decided to remove it.
LA_ID
Only released with the GAL
Product.
VO_ID
Only released with the GAL
Product.
A new section was added to
describe the GeoDirectory
Extranet site.
_________________________________________________________________________________
Page 74 of 76
An Post / Ordnance Survey Ireland
GeoDirectory Technical Guide
May 2012
Impact
Column Name
A new rule when creating the
addresses in the Address Model and
the Irish Addresses Model table.
A new Yes / No flag on the Buildings table
to indicate whether to include the Locality
in the address.
LOCALITY_POSTALLY_REQ
A new flag on the Buildings table.
If the flag is set to ‗N‘ then the Locality and
Secondary Locality will be omitted and if
it‘s set to‘ Y‘ it will be included when
populating the Address Model table.
Description
Character(1)
A large number of addresses, particularly
in the Dublin numbered districts, do not
require the Locality. GeoDirectory has
kept the link between the building and the
locality and this can be established by
linking the building and the localities tables.
July 2012
Impact
Rename the „Address_Model‟ table
to „Geographic_Format‟ table
Table name changed, but still has the
same layout.
Rename the Irish_Address_Model
table to „Irish_Geographic_Format‟
table
Table name changed, but still has the
same layout.
Rename the
„Address_Model_Changes‟ table to
„Geographic_Format_Changes‟ table
Table name changed, but still has the
same layout.
Rename the
„Irish_Address_Model_Changes‟ to
„Irish_Geographic_Format_Change‟
table
Table name changed, but still has the
same layout.
A new table called
„Official_Postal_Address‟ table.
A new table which contains the Official
Postal address and has the same layout as
the Geographic_format.
A new table called
„Irish_Official_Postal_Address‟ table
A new table which contains the Official
Postal address and has the same layout as
the Irish_Geographic_format.
A new column on the Localities table
called POST_TOWN_REQUIRED_AP
When populating the
OFFICIAL_POSTAL_ADDRESS and
IRISH_OFFICIAL_ADDRESS tables you
need to reference this Y/N flag to establish
if the Post Town is required as part of the
official address.
November 2012
Releasing the Small Areas boundary
set.
Impact
Renamed the SABS column on the
Buildings table to SAMLL_AREA_ID.
Column Name
POST_TOWN_REQUIRED_AP
Column Name
Description
Character(1)
Description
Small_Area_ID
Number(10)
CSO_ED_ID
Number(10)
A new look-up table called Small_Areas
Releasing the CSO Electoral Division
link ID.
The ER diagram was updated to
reflect the new table and column
name changes
A new column on the EDS table to show
the Central Statistics Office identification
number (ID) for the Electoral Division.
As an aid to linking GeoDirectory to CSO
statistics we have decided to include their
unique ID.
Diagram updated
_________________________________________________________________________________
Page 75 of 76
An Post / Ordnance Survey Ireland
May 2013
GeoDirectory Technical Guide
Impact
Column Name
Description
A new table called
BUILDING_DATUM
No impact to existing tables.
See Appendix F for full
Column descriptions
A new table called
DISTRICT_COURTS
No impact to existing tables.
See Appendix F for full
Column descriptions
Use this table and the CS_ID
on the EDS Table to show the
District Court for each
address.
See Appendix F for full
Column descriptions
This holds spatial datasets
not linked to Buildings.
See Appendix F for full
Column descriptions
A look-up table for
ADDITIONAL_FEATURES
PNONE_NUMBER
Character(20)
Data populated and released.
A new table called
ADDITIONAL_FEATURES
No impact to existing tables.
Data populated and released
A new table called
ADDITIONAL_FEATURE_TYPES
No impact to existing tables.
Data populated and released.
A new column on the
ADDRESS_POINTS table
New Column on table to hold the Phone
number for the Organisation
No data released
You will now be able to order
Townland data with the
GEOADDRESS product.
No impact to existing tables.
Academic Licence
No impact to existing tables.
The ER diagram was updated to
reflect the new table and column
name changes
If the products are to be used
for academic purposes then
you might be able to avail of
an Academic Licence.
Diagram updated
_________________________________________________________________________________
Page 76 of 76