What's New
This release includes new and updated datasets and bundles, Subdivision Code details, Filter multiple close match details, PO Box Support and bug fixes.
Note: As data is enriched with the quarterly refreshes, the size of the datasets could grow
thereby increasing memory requirements. Continuous housekeeping of your databases and
managing/deleting unused data is highly recommended for optimal performance.
For more information, see Geo Addressing Coverage.
New Datasets and Bundles
| Country Code (ISO3) | Country | Product Code | Bundle |
| BRA | Brazil | BR8 | Data Option 3 Address Geocoding WORLD and AMER bundles; Data Option 3 Address Verification WORLD and AMER bundles; À la carte available |
| BRA | Brazil | 8BR | Data Option 3 Address Autocomplete WORLD and AMER bundles; À la carte available |
| COL | Colombia | CO3 | Data Option 3 Address Geocoding WORLD and AMER bundles; Data Option 3 Address Verification WORLD and AMER bundles; No à la carte available |
| COL | Colombia | 3CO | Data Option 3 Address Autocomplete WORLD and AMER bundles; No à la carte available |
| ECU | Ecuador | EC3 | Data Option 3 Address Geocoding WORLD and AMER bundles; Data Option 3 Address Verification WORLD and AMER bundles; No à la carte available |
| ECU | Ecuador | 3EC | Data Option 3 Address Autocomplete WORLD and AMER bundles; No à la carte available |
| GAB | Gabon | GA3 | Data Option 3 Address Geocoding WORLD and EMEA bundles; Data Option 3 Address Verification WORLD and EMEA bundles; No à la carte available |
| GAB | Gabon | 3GA | Data Option 3 Address Autocomplete WORLD and EMEA bundles; No à la carte available |
| PRY | Paraguay | PY3 | Data Option 3 Address Geocoding WORLD and AMER bundles; Data Option 3 Address Verification WORLD and AMER bundles; No à la carte available |
| PRY | Paraguay | 3PY | Data Option 3 Address Autocomplete WORLD and AMER bundles; No à la carte available |
| LKA | Sri Lanka | LK3 | Data Option 3 Address Geocoding WORLD and APAC bundles; Data Option 3 Address Verification WORLD and APAC bundles; No à la carte available |
| LKA | Sri Lanka | 3LK | Data Option 3 Address Autocomplete WORLD and APAC bundles; No à la carte available |
Subdivision Codes
With this release we have introduced support for Subdivision Codes. A country's primary subdivision (such as a province or state, for example) is represented by its subdivision code in ISO 3166-1. Based on the two-letter ISO 3166-1 code element, this code consists of a separator and up to three alphanumeric characters. The characters after the separator cannot be used on their own to denote a subdivision, they must be preceded by the alpha-2 country code. The Subdivision Code has been implemented for the following MLDs: Belgium MLD (BEL), Germany MLD (DEU), Finland MLD (FIN),Ireland MLD (IRL), Netherlands MLD(NLD), Singapore MLD (SGP), Sweden MLD (SWE), Austrailia MLD (AUS), Brazil MLD (BRA), France MLD (FRA), and Canada MLD (CAN).
Below are the Request Response for Subdivision Code implementation:
Address Autocomplete Subdivision
Request
{
"preferences": {
"maxResults": 5,
"returnAllInfo": true,
"factoryDescription": {
"label": "",
"featureSpecific": {}
},
"clientLocale": "",
"clientCoordSysName": "",
"distance": {
"value": 150,
"distanceUnit": "METER"
},
"streetOffset": {
"value": 7,
"distanceUnit": "METER"
},
"cornerOffset": {
"value": 7,
"distanceUnit": "METER"
},
"customPreferences": {}
},
"address": {
"addressLines": [
"Caixa Postal 101051 A 101100, 136, Niterói 24350"
],
"country": "BRA",
"addressNumber": "",
"admin1": "",
"admin2": "",
"city": "",
"borough": "",
"neighborhood": "",
"suburb": "",
"postalCode": "",
"postalCodeExt": "",
"placeName": "",
"building": "",
"floor": "",
"room": "",
"unit": "",
"unitType": ""
}
}Address Autocomplete Subdivision
Response:
{
"status": "OK",
"predictions": [
{
"prediction": "Caixa Postal 101051 A 101100, 136, Niterói 24350",
"distance": {
"value": 0,
"distanceUnit": "METER"
},
"address": {
"formattedAddress": "Caixa Postal 101051 A 101100, 136 - Itaipu, Niterói - Rio De Janeiro, 24350",
"formattedStreetAddress": "Caixa Postal 101051 A 101100, 136",
"formattedLocationAddress": "Niterói 24350",
"addressNumber": "136",
"country": {
"isoAlpha3Code": "BRA"
},
"admin1": {
"longName": "Rio De Janeiro",
"shortName": "Rio De Janeiro"
},
"admin2": {},
"city": {
"longName": "Niterói",
"shortName": "Niterói"
},
"neighborhood": {
"longName": "Itaipu",
"shortName": "Itaipu"
},
"postalCode": "24350",
"street": "Caixa Postal 101051 A 101100"
},
"addressLines": [
"Caixa Postal 101051 A 101100, 136",
"Itaipu",
"Niterói - Rio De Janeiro",
"24350"
],
"location": {
"feature": {
"type": "Feature",
"properties": {
"crsName": "epsg:4326"
},
"geometry": {
"type": "Point",
"coordinates": [
-43.014345,
-22.939439999999998
]
}
}
},
"parsed": [
{}
],
"explanation": {
"addressMatch": {
"description": [
{
"label": "placeName",
"matchType": "NONE"
},
{
"label": "addressNumber",
"matchType": "EXACT",
"matchedSubstring": "136"
},
{
"label": "admin1",
"matchType": "NONE"
},
{
"label": "admin2",
"matchType": "NONE"
},
{
"label": "city",
"matchType": "PARTIAL",
"matchedSubstring": "NITEROI"
},
{
"label": "neighborhood",
"matchType": "NONE"
},
{
"label": "suburb",
"matchType": "NONE"
},
{
"label": "street",
"matchType": "EXACT",
"matchedSubstring": "CAIXA POSTAL 101051 A 101100"
},
{
"label": "postalCode",
"matchType": "EXACT",
"matchedSubstring": "24350"
},
{
"label": "streetType",
"matchType": "NONE"
},
{
"label": "postalCodeExt",
"matchType": "NONE"
},
{
"label": "streetDirectional",
"matchType": "NONE"
}
]
},
"source": {
"label": "ggs"
}
},
"customFields": {
"PB_KEY": "P0002K2TWFHS",
"SUB_DIVISION_CODE": "BR-RJ",
"DISTANCE": "-0.0",
"FROM_CUSTOM_DATASET": "false",
"MATCHED_FROM_ADDRESSNUMBER": "136",
"MATCHED_FROM_STREETNAME": "CAIXA POSTAL 101051 A 101100",
"ADDRESS_NUMBER_FROM": "136",
"DATA_PROVIDER": "MASTERLOCATION",
"PRODUCT_CODE": "8BR",
"FORMATTED_STRING": "Caixa Postal 101051 A 101100, 136, Niterói 24350",
"RECORD_TYPE": "2",
"MATCHED_FROM_POSTCODE": "24350",
"FEATUREID": "56017068",
"MATCHED_FROM_AREANAME3": "NITEROI",
"DISTANCE_UNIT": "METERS"
}
}
]
}Enterprise Global Module Subdivision
Request:
{
"preferences": {
"maxResults": 1,
"returnAllInfo": true,
"factoryDescription": {
"label": "",
"featureSpecific": {}
},
"clientLocale": "",
"clientCoordSysName": "",
"distance": {
"value": 150,
"distanceUnit": "METER"
},
"streetOffset": {
"value": 7,
"distanceUnit": "METER"
},
"cornerOffset": {
"value": 7,
"distanceUnit": "METER"
},
"customPreferences": {}
},
"addresses": [
{
"addressLines": [
"Rua Silvério Pereira Jordão, 105, Poá 08550030"
],
"country": "BRA",
"addressNumber": "",
"admin1": "",
"admin2": "",
"city": "",
"borough": "",
"neighborhood": "",
"suburb": "",
"postalCode": "",
"postalCodeExt": "",
"placeName": "",
"building": "",
"floor": "",
"room": "",
"unit": "",
"unitType": ""
}
]
}Enterprise Global Module Subdivision
Response:
{
"responses": [
{
"status": "OK",
"results": [
{
"score": 98,
"address": {
"formattedAddress": "RUA SILVÉRIO PEREIRA JORDÃO, 105 - POÁ - SP, 08550-030, Brazil",
"formattedStreetAddress": "RUA SILVÉRIO PEREIRA JORDÃO 105",
"formattedLocationAddress": "POÁ - SP 08550-030",
"addressNumber": "105",
"country": {
"name": "Brazil",
"isoAlpha2Code": "BR",
"isoAlpha3Code": "BRA",
"isoNumericCode": "076"
},
"admin1": {
"longName": "São Paulo",
"shortName": "SP"
},
"city": {
"longName": "POÁ",
"shortName": "POÁ"
},
"postalCode": "08550-030",
"street": "SILVÉRIO PEREIRA JORDÃO"
},
"addressLines": [
"RUA SILVÉRIO PEREIRA JORDÃO, 105",
"POÁ - SP",
"08550-030",
"Brazil"
],
"location": {
"explanation": {
"type": "ADDRESS_POINT"
},
"feature": {
"type": "Feature",
"properties": {
"crsName": "epsg:4326"
},
"geometry": {
"type": "Point",
"coordinates": [
-46.34467,
-23.5222
]
}
}
},
"explanation": {
"addressMatch": {
"type": "ADDRESS",
"description": [
{
"label": "placeName",
"matchType": "NONE"
},
{
"label": "addressNumber",
"matchType": "EXACT"
},
{
"label": "admin1",
"matchType": "NONE"
},
{
"label": "admin2",
"matchType": "NONE"
},
{
"label": "city",
"matchType": "EXACT"
},
{
"label": "neighborhood",
"matchType": "NONE"
},
{
"label": "suburb",
"matchType": "NONE"
},
{
"label": "street",
"matchType": "EXACT"
},
{
"label": "postalCode",
"matchType": "EXACT"
},
{
"label": "streetType",
"matchType": "EXACT"
},
{
"label": "postalCodeExt",
"matchType": "NONE"
},
{
"label": "streetDirectional",
"matchType": "EXACT"
}
]
},
"source": {
"label": "ggs"
}
},
"customFields": {
"PB_KEY": "P0002K2OQXL2",
"LANGUAGE": "pt",
"SEGMENT_ID": "42437782",
"SUB_DIVISION_CODE": "BR-SP",
"RESULT_CODE": "S8HPNTSCZA",
"PRECISION_LEVEL": "16",
"PRE_THOROUGHFARE_TYPE": "RUA",
"THOROUGHFARE_TYPE": "RUA",
"GEOHASH": "6gz41muv6bj7",
"DATA_PROVIDER": "MASTERLOCATION",
"PRODUCT_CODE": "BR8",
"MATCH_TYPE": "ADDRESS",
"MAIN_ADDRESS": "SILVÉRIO PEREIRA JORDÃO",
"GENERIC_FIELD_1": "SP",
"PRECISION_CODE": "S8HPNTSCZA"
},
"parsed": [
{
"classifications": [
{
"label": "street",
"value": "SILVÉRIO PEREIRA JORDÃO"
},
{
"label": "city",
"value": "POÁ"
},
{
"label": "addressNumber",
"value": "105"
},
{
"label": "postalCode",
"value": "08550 030"
},
{
"label": "country",
"value": "BRA"
},
{
"label": "streetPrefix",
"value": "RUA"
},
{
"label": "formattedInputStreet",
"value": "RUA SILVÉRIO PEREIRA JORDÃO 105"
},
{
"label": "genericField1",
"value": "105 08550030"
}
]
}
]
}
]
}
]
}Filter multiple close matches
With this release, the core level has been enhanced for all countries to restrict the matches to a single close match despite multiple dictionaries configured. World Geocoder is an exception.
Below are Request and Response for Filtering multiple close matches:
Filter multiple close matches
Request
{
"preferences": {
"maxResults": 100,
"returnAllInfo": true,
"factoryDescription": {
"label": "",
"featureSpecific": {}
},
"clientLocale": "",
"clientCoordSysName": "",
"distance": {
"value": 150,
"distanceUnit": "METER"
},
"streetOffset": {
"value": 7,
"distanceUnit": "METER"
},
"cornerOffset": {
"value": 7,
"distanceUnit": "METER"
},
"customPreferences": {}
},
"addresses": [
{
"addressLines": [
"Rua Silvério Pereira Jordão"
],
"country": "BRA",
"addressNumber": "",
"admin1": "",
"admin2": "",
"city": "",
"borough": "",
"neighborhood": "",
"suburb": "",
"postalCode": "",
"postalCodeExt": "",
"placeName": "",
"building": "",
"floor": "",
"room": "",
"unit": "",
"unitType": ""
}
]
}Filter multiple close matches
Response:
{
"responses": [
{
"status": "OK",
"results": [
{
"score": 46,
"address": {
"formattedAddress": "JORDÃO - AC, 69975-000, Brazil",
"formattedLocationAddress": "JORDÃO - AC 69975-000",
"country": {
"name": "Brazil",
"isoAlpha2Code": "BR",
"isoAlpha3Code": "BRA",
"isoNumericCode": "076"
},
"admin1": {
"longName": "Acre",
"shortName": "AC"
},
"city": {
"longName": "JORDÃO",
"shortName": "JORDÃO"
},
"postalCode": "69975-000"
},
"addressLines": [
"JORDÃO - AC",
"69975-000",
"Brazil"
],
"location": {
"explanation": {
"type": "CITY",
"designation": "CENTROID"
},
"feature": {
"type": "Feature",
"properties": {
"crsName": "epsg:4326"
},
"geometry": {
"type": "Point",
"coordinates": [
-71.94889,
-9.19153
]
}
}
},
"explanation": {
"addressMatch": {
"type": "ADMIN",
"description": [
{
"label": "placeName",
"matchType": "NONE"
},
{
"label": "addressNumber",
"matchType": "NONE"
},
{
"label": "admin1",
"matchType": "NONE"
},
{
"label": "admin2",
"matchType": "NONE"
},
{
"label": "city",
"matchType": "EXACT"
},
{
"label": "neighborhood",
"matchType": "NONE"
},
{
"label": "suburb",
"matchType": "NONE"
},
{
"label": "street",
"matchType": "NONE"
},
{
"label": "postalCode",
"matchType": "NONE"
},
{
"label": "streetType",
"matchType": "NONE"
},
{
"label": "postalCodeExt",
"matchType": "NONE"
},
{
"label": "streetDirectional",
"matchType": "NONE"
}
]
},
"source": {
"label": "ggs"
}
},
"customFields": {
"LANGUAGE": "pt",
"RESULT_CODE": "G3",
"GENERIC_FIELD_1": "AC",
"PRECISION_CODE": "G3",
"POSTCODE_COUNT_IN_AREA": "1",
"PRECISION_LEVEL": "10",
"GEOHASH": "6qkgdy8rmqe5",
"DATA_PROVIDER": "NAVTEQ",
"PRODUCT_CODE": "BR2",
"MATCH_TYPE": "ADMIN"
},
"parsed": [
{
"classifications": [
{
"label": "street",
"value": "SILVÉRIO PEREIRA"
},
{
"label": "city",
"value": "JORDÃO"
},
{
"label": "country",
"value": "BRA"
},
{
"label": "streetPrefix",
"value": "RUA"
},
{
"label": "formattedInputStreet",
"value": "RUA SILVÉRIO PEREIRA"
},
{
"label": "genericField1",
"value": "SILVÉRIO PEREIRA"
}
]
}
]
}
]
}
]
}PO Box Support for Global MLD
With this release PO Box Support has been added for United Kingdom (GBR), Canada (CAN) and Finland (FIN) for Address Autocomplete.
Below are the Request and Response for PO Box Support:
Request:
{
"preferences": {
"maxResults": 1,
"returnAllInfo": true,
"factoryDescription": {
"label": "",
"featureSpecific": {}
},
"clientLocale": "",
"clientCoordSysName": "",
"distance": {
"value": 150,
"distanceUnit": "METER"
},
"streetOffset": {
"value": 7,
"distanceUnit": "METER"
},
"cornerOffset": {
"value": 7,
"distanceUnit": "METER"
},
"customPreferences": {"SEARCH_ON_POBOX":"true"}
},
"address": {
"addressLines": [
"PO BOX"
],
"country": "GBR",
"addressNumber": "",
"admin1": "",
"admin2": "",
"city": "",
"borough": "",
"neighborhood": "",
"suburb": "",
"postalCode": "",
"postalCodeExt": "",
"placeName": "",
"building": "",
"floor": "",
"room": "",
"unit": "",
"unitType": ""
}
}{
"status": "OK",
"predictions": [
{
"prediction": "Po Box 10290, Aberdeen, AB10 1GS",
"distance": {
"value": 0,
"distanceUnit": "METER"
},
"address": {
"formattedAddress": "Po Box 10290, Aberdeen, AB10 1GS",
"formattedStreetAddress": "Po Box 10290",
"formattedLocationAddress": "Aberdeen, AB10 1GS",
"addressNumber": "10290",
"country": {
"isoAlpha3Code": "GBR"
},
"admin1": {},
"admin2": {},
"city": {
"longName": "Aberdeen",
"shortName": "Aberdeen"
},
"neighborhood": {},
"postalCode": "AB10 1GS",
"street": "Po Box"
},
"addressLines": [
"Po Box 10290",
"Aberdeen",
"AB10 1GS"
],
"location": {
"feature": {
"type": "Feature",
"properties": {
"crsName": "epsg:4326"
},
"geometry": {
"type": "Point",
"coordinates": [
-2.09401,
57.11132
]
}
}
},
"parsed": [
{}
],
"explanation": {
"addressMatch": {
"description": [
{
"label": "placeName",
"matchType": "NONE"
},
{
"label": "addressNumber",
"matchType": "NONE"
},
{
"label": "admin1",
"matchType": "NONE"
},
{
"label": "admin2",
"matchType": "NONE"
},
{
"label": "city",
"matchType": "NONE"
},
{
"label": "neighborhood",
"matchType": "NONE"
},
{
"label": "suburb",
"matchType": "NONE"
},
{
"label": "street",
"matchType": "EXACT",
"matchedSubstring": "PO BOX"
},
{
"label": "postalCode",
"matchType": "NONE"
},
{
"label": "streetType",
"matchType": "NONE"
},
{
"label": "postalCodeExt",
"matchType": "NONE"
},
{
"label": "streetDirectional",
"matchType": "NONE"
}
]
},
"source": {
"label": "ggs"
}
},
"customFields": {
"FORMATTED_STRING": "Po Box 10290, Aberdeen, AB10 1GS",
"DISTANCE": "-0.0",
"PO_BOX_ADDRESS": "TRUE",
"RECORD_TYPE": "3",
"FEATUREID": "00000200",
"FROM_CUSTOM_DATASET": "false",
"MATCHED_FROM_STREETNAME": "PO BOX",
"DISTANCE_UNIT": "METERS",
"DATA_PROVIDER": "MASTERLOCATION",
"PRODUCT_CODE": "GB8"
}
}
]
}Request:
{
"preferences": {
"maxResults": 1,
"returnAllInfo": true,
"factoryDescription": {
"label": "",
"featureSpecific": {}
},
"clientLocale": "",
"clientCoordSysName": "",
"distance": {
"value": 150,
"distanceUnit": "METER"
},
"streetOffset": {
"value": 7,
"distanceUnit": "METER"
},
"cornerOffset": {
"value": 7,
"distanceUnit": "METER"
},
"customPreferences": {}
},
"addresses": [
{
"addressLines": [
"Postfach, 74259 Widdern"
],
"country": "DEU",
"addressNumber": "",
"admin1": "",
"admin2": "",
"city": "",
"borough": "",
"neighborhood": "",
"suburb": "",
"postalCode": "",
"postalCodeExt": "",
"placeName": "",
"building": "",
"floor": "",
"room": "",
"unit": "",
"unitType": ""
}
]
}{
"responses": [
{
"status": "OK",
"results": [
{
"score": 73,
"address": {
"formattedAddress": "POSTFACH 20, 74259 Widdern, Germany",
"formattedStreetAddress": "POSTFACH 20",
"formattedLocationAddress": "74259 Widdern",
"country": {
"name": "Germany",
"isoAlpha2Code": "DE",
"isoAlpha3Code": "DEU",
"isoNumericCode": "276"
},
"admin1": {
"longName": "Baden-Württemberg",
"shortName": "BW"
},
"admin2": {
"longName": "Heilbronn",
"shortName": "Heilbronn"
},
"city": {
"longName": "Widdern",
"shortName": "Widdern"
},
"postalCode": "74259"
},
"addressLines": [
"POSTFACH 20",
"74259 Widdern",
"Germany"
],
"location": {
"explanation": {
"type": "POSTAL",
"description": "POSTAL_CODE",
"designation": "CENTROID"
},
"feature": {
"type": "Feature",
"properties": {
"crsName": "epsg:4326"
},
"geometry": {
"type": "Point",
"coordinates": [
9.41975,
49.3169
]
}
}
},
"explanation": {
"addressMatch": {
"type": "POBOX",
"description": [
{
"label": "placeName",
"matchType": "NONE"
},
{
"label": "addressNumber",
"matchType": "NONE"
},
{
"label": "admin1",
"matchType": "NONE"
},
{
"label": "admin2",
"matchType": "NONE"
},
{
"label": "city",
"matchType": "EXACT"
},
{
"label": "neighborhood",
"matchType": "NONE"
},
{
"label": "suburb",
"matchType": "NONE"
},
{
"label": "street",
"matchType": "EXACT"
},
{
"label": "postalCode",
"matchType": "NONE"
},
{
"label": "streetType",
"matchType": "EXACT"
},
{
"label": "postalCodeExt",
"matchType": "NONE"
},
{
"label": "streetDirectional",
"matchType": "EXACT"
}
]
},
"source": {
"label": "ggs"
}
},
"customFields": {
"LANGUAGE": "de",
"SEGMENT_ID": "2166460",
"SUB_DIVISION_CODE": "DE-BW",
"RESULT_CODE": "B1",
"PRECISION_LEVEL": "3",
"KEY_FORMATTED_POBOX": "POSTFACH 20",
"GEOHASH": "u0y8w3g7b06x",
"STREETDATATYPE": "15",
"DATA_PROVIDER": "MASTERLOCATION",
"PRODUCT_CODE": "DE8",
"MATCH_TYPE": "POBOX",
"PRECISION_CODE": "B1",
"KEY_POBOX": "POSTFACH",
"KEY_POBOX_NUMBER": "20"
},
"parsed": [
{
"classifications": [
{
"label": "street",
"value": "POSTFACH"
},
{
"label": "city",
"value": "WIDDERN"
},
{
"label": "addressNumber",
"value": "74259"
},
{
"label": "country",
"value": "DEU"
},
{
"label": "formattedInputStreet",
"value": "POSTFACH 74259"
}
]
}
]
}
]
}
]
}Note: Precisely is streamlining the bundling process by offering three
options. This release includes four new basic (Option 1) regional bundles each for Geo
Addressing SDK, Spectrum Global Addressing, Geocoding and Address Autocomplete. For details
on each option, please contact your Sales Account Executive.