With the long postcodes you have additional data to geocode your address that are available as a binary file. This contains all the long postcode information required for the PTV xLocate Server. At the moment they are offered for UK (7-digits) and for Netherlands (6-digits).
The Data folder contains the long postcodes for one of the following countries:
gbr_d.gpi file:This is the binary file of the long postcodes for UK (without Northern Ireland).
nld_d.gpi file:This is the binary file of the long postcodes for Netherlands.
To install the long postcodes you have to copy the binary file of your country to a subfolder of the map folder. The map folder is specified in the following configuration file:
<PTV xLocate Server folder>/conf/xlocate.properties in the maps.path key.
Take a look at the subfolders of the map folder. Usually there are already subfolders for each country (e.g. gbr_d), if not please create them following the schema <country code>_d. Then copy the binary file to the country folder (e.g the file gbr_d.gpi to the folder gbr_d).
There is no further configuration necessary. Please restart the PTV xLocate Server after the installation of the data.
In order to obtain results enter the long postcode in the corresponding address field of your application. Please note that you have to enter the complete 7-digit postcode for UK and the complete 6-digit postcode for NL (with or without blank). Otherwise only the map database will be used in order to find the address.
The example contains a findAddress request in Aberdeen. Please note that only country and postcode is used, all other fields are not considered in the search.
...
<findAddress xmlns="http://types.xlocate.xserver.ptvag.com">
<Address_1 country="GB" state="" postCode="AB101AU"city="" city2="" street="" houseNumber=""/>
...
</findAddress>
...
Then in the response you get an exact match with the coordinates and a complete address validation. Because of the Ordnance Survey data there is no street or city entry included.
The example contains a findAddress request in Amsterdam. Please note that only country and postcode is used, all other fields are not considered in the search.
...
<findAddress xmlns="http://types.xlocate.xserver.ptvag.com">
<Address_1 country="NL" state="" postCode="1011AA" city="" city2="" street="" houseNumber=""/>
...
</findAddress>
...
Then in the response you get an exact match with the coordinates and a complete address validation. In addition there is the city (Amsterdam), the street (De Ruyterkade Steigers) and the house number (3 – 10) included.
Copyright © 2024 PTV Logistics GmbH All rights reserved. | Imprint
