What's New

This release includes new and updated data sets and bundles, Building Footprints support, Postal Indicator support, Key Lookup 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.

Datasets and Bundle Information

Previous Product code Current Product Code Previous dataset / bundle name Current dataset/ bundle name Details
N/A 1AGSKD3 WRLD N/A ADDRESSING GEO ADDRESSING DATA OPTION 3 WORLD GLOBAL ALL GLB This is a new World bundle for premium address verification in the Geo Addressing SDK
N/A 1AGSKD3 AMER N/A ADDRESSING GEO ADDRESSING DATA OPTION 3 AMER AMERICAS ALL AME This is a new AMER bundle for premium address verification in the Geo Addressing SDK
N/A 1AGSKD3 EMEA N/A ADDRESSING GEO ADDRESSING DATA OPTION 3 EMEA EUROPE, MIDDLE EAST, AFRICA ALL EMA This is a new EMEA bundle for premium address verification in the Geo Addressing SDK
N/A 1AGSKD3 APAC N/A ADDRESSING GEO ADDRESSING DATA OPTION 3 APAC ASIA ALL APA This is a new APAC bundle for premium address verification in the Geo Addressing SDK
N/A 5AGAV3 WRLD N/A SPECTRUM CIM GLOBAL ADDRESS VALIDATION DATA OPTION 3 WORLD GLOBAL ALL GLB This is a new World bundle for premium address verification in Spectrum Global Addressing
N/A 5AGAV3 AMER N/A SPECTRUM CIM GLOBAL ADDRESS VALIDATION DATA OPTION 3 AMER AMERICAS ALL AME This is a new AMER bundle for premium address verification in Spectrum Global Addressing
N/A 5AGAV3 EMEA N/A SPECTRUM CIM GLOBAL ADDRESS VALIDATION DATA OPTION 3 EMEA EUROPE, MIDDLE EAST, AFRICA ALL EMA This is a new EMEA bundle for premium address verification in Spectrum Global Addressing
N/A 5AGAV3 APAC N/A SPECTRUM CIM GLOBAL ADDRESS VALIDATION DATA OPTION 3 APAC ASIA ALL APA This is a new APAC bundle for premium address verification in Spectrum Global Addressing
MLDB 1GHC13 WRLD GEOCODING GEOCODING MLD WORLD GLOBAL ALL GLB GEOCODING GEOCODING DATA OPTION 3 WORLD GLOBAL ALL GLB This is a World bundle that combines the MLD Bundle with all global datasets for premium geocoding
N/A 1GHC13 AMER N/A GEOCODING GEOCODING DATA OPTION 3 AMER AMERICAS ALL AME This is a new AMER bundle that includes MLD for premium geocoding
N/A 1GHC13 EMEA N/A GEOCODING GEOCODING DATA OPTION 3 EMEA EUROPE, MIDDLE EAST, AFRICA ALL EMA This is a new EMEA bundle that includes MLD for premium geocoding
N/A 1GHC13 APAC N/A GEOCODING GEOCODING DATA OPTION 3 APAC ASIA ALL APA This is a new APAC bundle that includes MLD for premium geocoding
N/A 5ATAD3 WRLD N/A SPECTRUM CIM AUTOCOMPLETE DATA OPTION 3 WORLD GLOBAL ALL GLB This is a new World bundle for premium Address Autocomplete
N/A 5ATAD3 AMER N/A SPECTRUM CIM AUTOCOMPLETE DATA OPTION 3 AMER AMERICAS ALL AME This is a new AMER bundle for premium Address Autocomplete
N/A 5ATAD3 EMEA N/A SPECTRUM CIM AUTOCOMPLETE DATA OPTION 3 EMEA EUROPE, MIDDLE EAST, AFRICA ALL EMA This is a new EMEA bundle for premium Address Autocomplete
N/A 5ATAD3 APAC N/A SPECTRUM CIM AUTOCOMPLETE DATA OPTION 3 APAC ASIA ALL APA This is a new APAC bundle for premium Address Autocomplete
Note: Precisely is streamlining the bundling process by offering three options. This release includes four new premium (Option 3) 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.

DPID support for Australia

A Delivery Point Identifier (DPID) is a unique 8-digit number attached to every address in Australia Post's database. A DPID can be printed on envelopes as a barcode to be easily scanned, sorted, and sent by Australia Post, making direct mail faster, more reliable, and simpler to manage. With this release we have introduced the support for Australia DPID.

Canada Geocoding Enhancement

Improved geocoding precision level 19 results for a section of the Toronto area near 128 Fern Ave. More geocoding address locations in this area will now be identified to fall within a building structure.

Key Lookup

Key Lookup allows you to find an address using a PreciselyID unique identifier as input and return all standard returns that are provided as part of address matching. Lookup supported countries are as follows:

Precisely Key Lookup (Key : PB_KEY) capability is supported for United States of America(USA), Canada (CAN), France (FRA) and Germany (DEU).

Precisely Key Lookup (Key: GNAF_PID) capability is supported for Australia (AUS).

The Request and Response for Key Lookup are below:

Request
{
  "type": "PB_KEY",
  "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": {}
  },
  "keys": [
    {
      "keyValues": [
        {
          "key": "PBKEY",
          "value": "P0001AFCWP75"
        },
        {
          "key": "country",
          "value": "FRA"
        }
      ]
    }
  ]
}
Response
{
  "responses": [
    {
      "status": "OK",
      "results": [
        {
          "score": 0,
          "address": {
            "formattedAddress": "6t place de l'Église, 72300 La Chapelle-D'Aligné, France",
            "formattedStreetAddress": "6t place de l'Église",
            "formattedLocationAddress": "72300 La Chapelle-D'Aligné",
            "addressNumber": "6t",
            "country": {
              "name": "France",
              "isoAlpha2Code": "FR",
              "isoAlpha3Code": "FRA",
              "isoNumericCode": "250"
            },
            "admin1": {
              "longName": "Pays de la Loire",
              "shortName": "PDL"
            },
            "admin2": {
              "longName": "Sarthe",
              "shortName": "Sarthe"
            },
            "city": {
              "longName": "La Chapelle-D'Aligné",
              "shortName": "La Chapelle-D'Aligné"
            },
            "postalCode": "72300",
            "street": "de l'Église"
          },
          "addressLines": [
            "6t place de l'Église",
            "72300 La Chapelle-D'Aligné",
            "France"
          ],
          "location": {
            "explanation": {
              "type": "ADDRESS_POINT"
            },
            "feature": {
              "type": "Feature",
              "properties": {
                "crsName": "epsg:4326"
              },
              "geometry": {
                "type": "Point",
                "coordinates": [
                  -0.23548,
                  47.7327
                ]
              }
            }
          },
          "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": "NONE"
                },
                {
                  "label": "postalCode",
                  "matchType": "NONE"
                },
                {
                  "label": "streetType",
                  "matchType": "NONE"
                },
                {
                  "label": "postalCodeExt",
                  "matchType": "NONE"
                },
                {
                  "label": "streetDirectional",
                  "matchType": "NONE"
                }
              ]
            },
            "source": {
              "label": "ggs"
            }
          },
          "customFields": {
            "MAIN_ADDRESS": "de l'Église",
            "PB_KEY": "P0001AFCWP75",
            "LANGUAGE": "fr",
            "RESULT_CODE": "S8A",
            "PRECISION_CODE": "S8A",
            "PRE_THOROUGHFARE_TYPE": "place",
            "THOROUGHFARE_TYPE": "place",
            "GEOHASH": "gbrzd9kx0ujq",
            "STREETDATATYPE": "15",
            "IRIS_CODE": "720610000",
            "DATA_PROVIDER": "MASTERLOCATION",
            "PRODUCT_CODE": "FR8"
          },
          "parsed": [
            {}
          ]
        }
      ]
    }
  ]
}

Postal Indicator

Postal Indicator verifies addresses against the database to determine deliverability. Matching records are marked Yes. If they have no matching entry, they are marked No implying post cannot be delivered. Postal Indicator is now supported for Australia (AUS), Canada (CAN), and France (FRA) MLD.

The Request and Response for Postal Indicator are shown below:

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": ["Route du"],
    "country": "FRA",
    "addressNumber": "",
    "admin1": "",
    "admin2": "",
    "city": "",
    "borough": "",
    "neighborhood": "",
    "suburb": "",
    "postalCode": "",
    "postalCodeExt": "",
    "placeName": "",
    "building": "",
    "floor": "",
    "room": "",
    "unit": "",
    "unitType": ""
  }
}
Response
{
  "status": "OK",
  "predictions": [
    {
      "prediction": "837 route du Premier Pont, 42140, Maringes",
      "distance": {
        "value": 0,
        "distanceUnit": "METER"
      },
      "address": {
        "formattedAddress": "837 route du Premier Pont, 42140 Maringes",
        "formattedStreetAddress": "837 route du Premier Pont",
        "formattedLocationAddress": "42140, Maringes",
        "addressNumber": "837",
        "country": {
          "isoAlpha3Code": "FRA"
        },
        "admin1": {
          "longName": "Auvergne-Rhône-Alpes",
          "shortName": "Auvergne-Rhône-Alpes"
        },
        "admin2": {
          "longName": "Loire",
          "shortName": "Loire"
        },
        "city": {
          "longName": "Maringes",
          "shortName": "Maringes"
        },
        "neighborhood": {},
        "postalCode": "42140",
        "street": "route du Premier Pont"
      },
      "addressLines": [
        "837 route du Premier Pont",
        "42140 Maringes"
      ],
      "location": {
        "feature": {
          "type": "Feature",
          "properties": {
            "crsName": "epsg:4326"
          },
          "geometry": {
            "type": "Point",
            "coordinates": [
              4.363575,
              45.647425
            ]
          }
        }
      },
      "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": "PARTIAL",
              "matchedSubstring": "RT DU"
            },
            {
              "label": "postalCode",
              "matchType": "NONE"
            },
            {
              "label": "streetType",
              "matchType": "NONE"
            },
            {
              "label": "postalCodeExt",
              "matchType": "NONE"
            },
            {
              "label": "streetDirectional",
              "matchType": "NONE"
            }
          ]
        },
        "source": {
          "label": "ggs"
        }
      },
      "customFields": {
        "PB_KEY": "P0001AFEQ2Y8",
        "FORMATTED_STRING": "837 route du Premier Pont, 42140, Maringes",
        "DISTANCE": "-0.0",
        "RECORD_TYPE": "2",
        "FEATUREID": "28278888",
        "FROM_CUSTOM_DATASET": "false",
        "MATCHED_FROM_STREETNAME": "RT DU",
        "DISTANCE_UNIT": "METERS",
        "DATA_PROVIDER": "MASTERLOCATION",
        "PRODUCT_CODE": "FR8",
        "INPOSTAL": "t"
      }
    },
    {
      "prediction": "1008 route du 1er Janvier 1973, 69430, Régnié-Durette",
      "distance": {
        "value": 0,
        "distanceUnit": "METER"
      },
      "address": {
        "formattedAddress": "1008 route du 1er Janvier 1973, 69430 Régnié-Durette",
        "formattedStreetAddress": "1008 route du 1er Janvier 1973",
        "formattedLocationAddress": "69430, Régnié-Durette",
        "addressNumber": "1008",
        "country": {
          "isoAlpha3Code": "FRA"
        },
        "admin1": {
          "longName": "Auvergne-Rhône-Alpes",
          "shortName": "Auvergne-Rhône-Alpes"
        },
        "admin2": {
          "longName": "Rhône",
          "shortName": "Rhône"
        },
        "city": {
          "longName": "Régnié-Durette",
          "shortName": "Régnié-Durette"
        },
        "neighborhood": {},
        "postalCode": "69430",
        "street": "route du 1er Janvier 1973"
      },
      "addressLines": [
        "1008 route du 1er Janvier 1973",
        "69430 Régnié-Durette"
      ],
      "location": {
        "feature": {
          "type": "Feature",
          "properties": {
            "crsName": "epsg:4326"
          },
          "geometry": {
            "type": "Point",
            "coordinates": [
              4.637945,
              46.129905
            ]
          }
        }
      },
      "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": "PARTIAL",
              "matchedSubstring": "RT DU"
            },
            {
              "label": "postalCode",
              "matchType": "NONE"
            },
            {
              "label": "streetType",
              "matchType": "NONE"
            },
            {
              "label": "postalCodeExt",
              "matchType": "NONE"
            },
            {
              "label": "streetDirectional",
              "matchType": "NONE"
            }
          ]
        },
        "source": {
          "label": "ggs"
        }
      },
      "customFields": {
        "PB_KEY": "P0001AEWPYMC",
        "FORMATTED_STRING": "1008 route du 1er Janvier 1973, 69430, Régnié-Durette",
        "DISTANCE": "-0.0",
        "RECORD_TYPE": "2",
        "FEATUREID": "1974202",
        "FROM_CUSTOM_DATASET": "false",
        "MATCHED_FROM_STREETNAME": "RT DU",
        "DISTANCE_UNIT": "METERS",
        "DATA_PROVIDER": "MASTERLOCATION",
        "PRODUCT_CODE": "FR8",
        "INPOSTAL": "t"
      }
    },
    {
      "prediction": "1423 route du Premier Pont, 42140, Chazelles-sur-Lyon",
      "distance": {
        "value": 0,
        "distanceUnit": "METER"
      },
      "address": {
        "formattedAddress": "1423 route du Premier Pont, 42140 Chazelles-sur-Lyon",
        "formattedStreetAddress": "1423 route du Premier Pont",
        "formattedLocationAddress": "42140, Chazelles-sur-Lyon",
        "addressNumber": "1423",
        "country": {
          "isoAlpha3Code": "FRA"
        },
        "admin1": {
          "longName": "Auvergne-Rhône-Alpes",
          "shortName": "Auvergne-Rhône-Alpes"
        },
        "admin2": {
          "longName": "Loire",
          "shortName": "Loire"
        },
        "city": {
          "longName": "Chazelles-sur-Lyon",
          "shortName": "Chazelles-sur-Lyon"
        },
        "neighborhood": {},
        "postalCode": "42140",
        "street": "route du Premier Pont"
      },
      "addressLines": [
        "1423 route du Premier Pont",
        "42140 Chazelles-sur-Lyon"
      ],
      "location": {
        "feature": {
          "type": "Feature",
          "properties": {
            "crsName": "epsg:4326"
          },
          "geometry": {
            "type": "Point",
            "coordinates": [
              4.36475,
              45.64593
            ]
          }
        }
      },
      "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": "PARTIAL",
              "matchedSubstring": "RT DU"
            },
            {
              "label": "postalCode",
              "matchType": "NONE"
            },
            {
              "label": "streetType",
              "matchType": "NONE"
            },
            {
              "label": "postalCodeExt",
              "matchType": "NONE"
            },
            {
              "label": "streetDirectional",
              "matchType": "NONE"
            }
          ]
        },
        "source": {
          "label": "ggs"
        }
      },
      "customFields": {
        "PB_KEY": "P0001AEZCSOJ",
        "FORMATTED_STRING": "1423 route du Premier Pont, 42140, Chazelles-sur-Lyon",
        "DISTANCE": "-0.0",
        "RECORD_TYPE": "2",
        "FEATUREID": "5838368",
        "FROM_CUSTOM_DATASET": "false",
        "MATCHED_FROM_STREETNAME": "RT DU",
        "DISTANCE_UNIT": "METERS",
        "DATA_PROVIDER": "MASTERLOCATION",
        "PRODUCT_CODE": "FR8",
        "INPOSTAL": "t"
      }
    },
    {
      "prediction": "1 route du 1er Mai, 33660, Saint-Sauveur-de-Puynormand",
      "distance": {
        "value": 0,
        "distanceUnit": "METER"
      },
      "address": {
        "formattedAddress": "1 route du 1er Mai, 33660 Saint-Sauveur-de-Puynormand",
        "formattedStreetAddress": "1 route du 1er Mai",
        "formattedLocationAddress": "33660, Saint-Sauveur-de-Puynormand",
        "addressNumber": "1",
        "country": {
          "isoAlpha3Code": "FRA"
        },
        "admin1": {
          "longName": "Nouvelle-Aquitaine",
          "shortName": "Nouvelle-Aquitaine"
        },
        "admin2": {
          "longName": "Gironde",
          "shortName": "Gironde"
        },
        "city": {
          "longName": "Saint-Sauveur-de-Puynormand",
          "shortName": "Saint-Sauveur-de-Puynormand"
        },
        "neighborhood": {},
        "postalCode": "33660",
        "street": "route du 1er Mai"
      },
      "addressLines": [
        "1 route du 1er Mai",
        "33660 Saint-Sauveur-de-Puynormand"
      ],
      "location": {
        "feature": {
          "type": "Feature",
          "properties": {
            "crsName": "epsg:4326"
          },
          "geometry": {
            "type": "Point",
            "coordinates": [
              -0.0377,
              44.99844
            ]
          }
        }
      },
      "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": "PARTIAL",
              "matchedSubstring": "RT DU"
            },
            {
              "label": "postalCode",
              "matchType": "NONE"
            },
            {
              "label": "streetType",
              "matchType": "NONE"
            },
            {
              "label": "postalCodeExt",
              "matchType": "NONE"
            },
            {
              "label": "streetDirectional",
              "matchType": "NONE"
            }
          ]
        },
        "source": {
          "label": "ggs"
        }
      },
      "customFields": {
        "PB_KEY": "P0001AEVSOJK",
        "FORMATTED_STRING": "1 route du 1er Mai, 33660, Saint-Sauveur-de-Puynormand",
        "DISTANCE": "-0.0",
        "RECORD_TYPE": "2",
        "FEATUREID": "641659",
        "FROM_CUSTOM_DATASET": "false",
        "MATCHED_FROM_STREETNAME": "RT DU",
        "DISTANCE_UNIT": "METERS",
        "DATA_PROVIDER": "MASTERLOCATION",
        "PRODUCT_CODE": "FR8",
        "INPOSTAL": "t"
      }
    },
    {
      "prediction": "1 route du Premier Villard, 73130, Saint-Alban-des-Villards",
      "distance": {
        "value": 0,
        "distanceUnit": "METER"
      },
      "address": {
        "formattedAddress": "1 route du Premier Villard, 73130 Saint-Alban-des-Villards",
        "formattedStreetAddress": "1 route du Premier Villard",
        "formattedLocationAddress": "73130, Saint-Alban-des-Villards",
        "addressNumber": "1",
        "country": {
          "isoAlpha3Code": "FRA"
        },
        "admin1": {
          "longName": "Auvergne-Rhône-Alpes",
          "shortName": "Auvergne-Rhône-Alpes"
        },
        "admin2": {
          "longName": "Savoie",
          "shortName": "Savoie"
        },
        "city": {
          "longName": "Saint-Alban-des-Villards",
          "shortName": "Saint-Alban-des-Villards"
        },
        "neighborhood": {},
        "postalCode": "73130",
        "street": "route du Premier Villard"
      },
      "addressLines": [
        "1 route du Premier Villard",
        "73130 Saint-Alban-des-Villards"
      ],
      "location": {
        "feature": {
          "type": "Feature",
          "properties": {
            "crsName": "epsg:4326"
          },
          "geometry": {
            "type": "Point",
            "coordinates": [
              6.255305,
              45.314009999999996
            ]
          }
        }
      },
      "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": "PARTIAL",
              "matchedSubstring": "RT DU"
            },
            {
              "label": "postalCode",
              "matchType": "NONE"
            },
            {
              "label": "streetType",
              "matchType": "NONE"
            },
            {
              "label": "postalCodeExt",
              "matchType": "NONE"
            },
            {
              "label": "streetDirectional",
              "matchType": "NONE"
            }
          ]
        },
        "source": {
          "label": "ggs"
        }
      },
      "customFields": {
        "PB_KEY": "P0001AG75W1R",
        "FORMATTED_STRING": "1 route du Premier Villard, 73130, Saint-Alban-des-Villards",
        "DISTANCE": "-0.0",
        "RECORD_TYPE": "2",
        "FEATUREID": "30754062",
        "FROM_CUSTOM_DATASET": "false",
        "MATCHED_FROM_STREETNAME": "RT DU",
        "DISTANCE_UNIT": "METERS",
        "DATA_PROVIDER": "MASTERLOCATION",
        "PRODUCT_CODE": "FR8",
        "INPOSTAL": "f"
      }
    }
  ]
}

Desired Language Support (3 languages) for JPN

For all the multilingual countries, the RETURN_ALT_LANG_FIELDS constraint was used to convert fields to the alternate language. With this release, to support the alternate language feature for Japan, a new custom constraint called DESIRED_ALT_LANGUAGE has been implemented. This constraint accepts a two-letter language code as a parameter. User now has a capability to provide language code for Latin (EN), Katakana (KA) or Kanji (JA) for which they want the response. Output language needs be one that the country supports (EN, KA, JA). This feature is implemented only for Japan and all other multilingual countries would not be impacted by this functionality.

customPreferences: {

   "DESIRED_ALT_LANGUAGE":"JA"

}

The Request and Response for desired language support are shown below:

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": {
	  "DESIRED_ALT_LANGUAGE":"JA"
    }
  },
  "addresses": [
    {
      "addressLines": [
        "12-11 AOBAMACHI SENDAI-SHI AOBA-KU MIYAGI"
      ],
      "country": "JPN",
      "addressNumber": "",
      "admin1": "",
      "admin2": "",
      "city": "",
      "borough": "",
      "neighborhood": "",
      "suburb": "",
      "postalCode": "",
      "postalCodeExt": "",
      "placeName": "",
      "building": "",
      "floor": "",
      "room": "",
      "unit": "",
      "unitType": ""
    }
  ]
}
Response
{
  "responses": [
    {
      "status": "OK",
      "results": [
        {
          "score": 97,
          "address": {
            "formattedAddress": "981-0916, 宮城県青葉町12-11, Japan",
            "formattedStreetAddress": "宮城県仙台市青葉区青葉町12-11",
            "formattedLocationAddress": "981-0916",
            "addressNumber": "11",
            "country": {
              "name": "Japan",
              "isoAlpha2Code": "JP",
              "isoAlpha3Code": "JPN",
              "isoNumericCode": "392"
            },
            "admin1": {
              "longName": "宮城県",
              "shortName": "宮城県"
            },
            "admin2": {
              "longName": "仙台市青葉区",
              "shortName": "仙台市青葉区"
            },
            "city": {
              "longName": "青葉町",
              "shortName": "青葉町"
            },
            "postalCode": "981-0916",
            "street": "12"
          },
          "addressLines": [
            "981-0916",
            "宮城県青葉町12-11",
            "Japan"
          ],
          "location": {
            "explanation": {
              "type": "ADDRESS_POINT"
            },
            "feature": {
              "type": "Feature",
              "properties": {
                "crsName": "epsg:4326"
              },
              "geometry": {
                "type": "Point",
                "coordinates": [
                  140.8624190832173,
                  38.28613776469981
                ]
              }
            }
          },
          "explanation": {
            "addressMatch": {
              "type": "ADDRESS",
              "description": [
                {
                  "label": "placeName",
                  "matchType": "NONE"
                },
                {
                  "label": "addressNumber",
                  "matchType": "EXACT"
                },
                {
                  "label": "admin1",
                  "matchType": "EXACT"
                },
                {
                  "label": "admin2",
                  "matchType": "EXACT"
                },
                {
                  "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": "ja",
            "MAIN_ADDRESS": "12",
            "JUSHO_CODE": "04101001000",
            "RESULT_CODE": "S8HPNTSC-A",
            "PRECISION_CODE": "S8HPNTSC-A",
            "GO": "11",
            "GEOHASH": "xnu1v3ubum27",
            "BANCHI": "12",
            "DATA_PROVIDER": "IPC",
            "PRODUCT_CODE": "JP7",
            "MATCH_TYPE": "ADDRESS"
          },
          "parsed": [
            {
              "classifications": [
                {
                  "label": "street",
                  "value": "12"
                },
                {
                  "label": "admin1",
                  "value": "MIYAGI"
                },
                {
                  "label": "admin2",
                  "value": "SENDAI SHI AOBA KU"
                },
                {
                  "label": "city",
                  "value": "AOBAMACHI"
                },
                {
                  "label": "addressNumber",
                  "value": "11"
                },
                {
                  "label": "country",
                  "value": "JPN"
                },
                {
                  "label": "genericField1",
                  "value": "-11  SENDAI-SHI AOBA-KU"
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Added new Territory GBR (IMN)

Isle of Man (IMN) is the new territory which has been added to Great Britain (GBR) geocoder. Address of (IMN) can now be gecoded through GBR geocoder.

The request and response for this feature are shown below:

Request
{
  "type": "ADDRESS",
  "preferences": {
    "returnAllCandidateInfo": true,
    "fallbackToGeographic": true,
    "fallbackToPostal": true,
    "maxReturnedCandidates": 1,
    "distance": 150,
    "streetOffset": 150,
    "cornerOffset": 150,
    "matchMode": "STANDARD",
    "clientLocale": null,
    "distanceUnits": "METERS",
    "streetOffsetUnits": "METERS",
    "cornerOffsetUnits": "METERS",
    "mustMatchFields": {},
    "returnFieldsDescriptor": {},
    "preferredDictionaryOrders": [],
    "originXY": [],
    "restrictedSearch": {},
    "maxRanges": 1,
    "maxRangeUnits": 1
  },
  "addresses": [
    {
      "addressLastLine": "",
      "addressNumber": "",
      "areaName1": "",
      "areaName2": "",
      "areaName3": "",
      "areaName4": "",
      "country": "IMN",
      "customFields": {},
      "mainAddressLine": "11 Mount Rule Road Glen Vine IM4 4BY",
      "placeName": "",
      "postCode1": "",
      "postCode2": "",
      "streetName": "",
      "unitType": "",
      "unitValue": ""
    }
  ]
}
Response
{
  "responses": [
    {
      "totalPossibleCandidates": 1,
      "totalMatches": 1,
      "candidates": [
        {
          "precisionLevel": 16,
          "formattedStreetAddress": "11 MOUNT RULE ROAD",
          "formattedLocationAddress": "GLEN VINE IM4 4BY",
          "precisionCode": "S8HPNTSCZA",
          "sourceDictionary": "0",
          "matching": {
            "matchOnAddressNumber": true,
            "matchOnPostCode1": true,
            "matchOnPostCode2": false,
            "matchOnAreaName1": false,
            "matchOnAreaName2": false,
            "matchOnAreaName3": true,
            "matchOnAreaName4": false,
            "matchOnAllStreetFields": true,
            "matchOnStreetName": true,
            "matchOnStreetType": true,
            "matchOnStreetDirectional": true,
            "matchOnPlaceName": false,
            "matchOnInputFields": false
          },
          "geometry": {
            "type": "Point",
            "coordinates": [
              -4.52397,
              54.18179
            ],
            "crs": {
              "type": "name",
              "properties": {
                "name": "epsg:4326"
              }
            }
          },
          "address": {
            "mainAddressLine": "11 MOUNT RULE ROAD",
            "addressLastLine": "GLEN VINE IM4 4BY",
            "areaName3": "GLEN VINE",
            "postCode1": "IM4 4BY",
            "country": "IMN",
            "addressNumber": "11",
            "streetName": "RULE",
            "customFields": {
              "PB_KEY": "P0002JW7EFSQ",
              "LANGUAGE": "en",
              "RESULT_CODE": "S8HPNTSCZA",
              "PRE_THOROUGHFARE_TYPE": "MOUNT",
              "POST_THOROUGHFARE_TYPE": "ROAD",
              "THOROUGHFARE_TYPE": "ROAD",
              "GEOHASH": "gcsu1p3xzceq",
              "DATA_PROVIDER": "MASTERLOCATION",
              "PRODUCT_CODE": "GB8",
              "MAIN_ADDRESS": "RULE",
              "ADDRESS_LINE1": "11 MOUNT RULE ROAD",
              "ADDRESS_LINE2": "GLEN VINE",
              "ADDRESS_LINE3": "IM4 4BY",
              "MATCH_SCORE": "98"
            }
          },
          "ranges": [
            {
              "lowHouse": "11",
              "side": "UNKNOWN",
              "oddEvenIndicator": "UNKNOWN",
              "units": [],
              "customValues": {
                "PB_KEY": "P0002JW7EFSQ"
              }
            }
          ]
        }
      ],
      "customValues": {
        "PARSED_INPUT_AREA_NAME_3": "GLEN VINE",
        "PARSED_INPUT_POST_CODE_1": "IM4 4BY",
        "PARSED_INPUT_STREET_NAME": "MOUNT RULE",
        "PARSED_INPUT_ADDRESS_NUMBER": "11",
        "PARSED_INPUT_STREET_POST_TYPE": "ROAD",
        "PARSED_INPUT_COUNTRY": "IMN",
        "PARSED_INPUT_FORMATTEDINPUTSTREET": "11, MOUNT RULE ROAD"
      }
    }
  ]
}

Added new Territory FRA (MCO)

Monaco is the new territory which has been added to France (FRA) geocoder. Address of Monaco can now be gecoded through FRA geocoder.

The request and response for this feature are shown below:

Request
{
  "type": "ADDRESS",
  "preferences": {
    "returnAllCandidateInfo": true,
    "fallbackToGeographic": true,
    "fallbackToPostal": true,
    "maxReturnedCandidates": 1,
    "distance": 150,
    "streetOffset": 150,
    "cornerOffset": 150,
    "matchMode": "STANDARD",
    "clientLocale": null,
    "distanceUnits": "METERS",
    "streetOffsetUnits": "METERS",
    "cornerOffsetUnits": "METERS",
    "mustMatchFields": {},
    "returnFieldsDescriptor": {},
    "preferredDictionaryOrders": [],
    "originXY": [],
    "restrictedSearch": {},
    "maxRanges": 1,
    "maxRangeUnits": 1
  },
  "addresses": [
    {
      "addressLastLine": "",
      "addressNumber": "",
      "areaName1": "",
      "areaName2": "",
      "areaName3": "",
      "areaName4": "",
      "country": "MCO",
      "customFields": {},
      "mainAddressLine": "16 RUE LOUIS AUREGLIA MONACO 98000",
      "placeName": "",
      "postCode1": "",
      "postCode2": "",
      "streetName": "",
      "unitType": "",
      "unitValue": ""
    }
  ]
}

Response
{
  "responses": [
    {
      "totalPossibleCandidates": 1,
      "totalMatches": 1,
      "candidates": [
        {
          "precisionLevel": 1,
          "formattedStreetAddress": "16 rue Louis Auréglia",
          "formattedLocationAddress": "98000 Monaco",
          "identifier": "2445179",
          "precisionCode": "S5HPNTSCZA",
          "sourceDictionary": "2",
          "matching": {
            "matchOnAddressNumber": true,
            "matchOnPostCode1": true,
            "matchOnPostCode2": false,
            "matchOnAreaName1": false,
            "matchOnAreaName2": false,
            "matchOnAreaName3": true,
            "matchOnAreaName4": false,
            "matchOnAllStreetFields": true,
            "matchOnStreetName": true,
            "matchOnStreetType": true,
            "matchOnStreetDirectional": true,
            "matchOnPlaceName": true,
            "matchOnInputFields": false
          },
          "geometry": {
            "type": "Point",
            "coordinates": [
              7.419603557079451,
              43.734564194046655
            ],
            "crs": {
              "type": "name",
              "properties": {
                "name": "epsg:4326"
              }
            }
          },
          "address": {
            "mainAddressLine": "16 rue Louis Auréglia",
            "addressLastLine": "98000 Monaco",
            "areaName1": "Monaco",
            "areaName2": "Monaco",
            "areaName3": "Monaco",
            "areaName4": "Les Moneghetti",
            "postCode1": "98000",
            "country": "MCO",
            "addressNumber": "16",
            "streetName": "Louis Auréglia",
            "customFields": {
              "ADDRESS_FIELD_VALIDATION": "P-G-B-E-F-C-S-T-V-X-Y-Hm",
              "LANGUAGE": "fr",
              "SEGMENT_ID": "2445179",
              "RESULT_CODE": "S5HPNTSCZA",
              "PRE_THOROUGHFARE_TYPE": "rue",
              "THOROUGHFARE_TYPE": "rue",
              "GEOHASH": "spv2bcdu339m",
              "STREETDATATYPE": "15",
              "DATA_PROVIDER": "TOMTOM",
              "PRODUCT_CODE": "FR1",
              "MAIN_ADDRESS": "Louis Auréglia",
              "ADDRESS_LINE1": "16 rue Louis Auréglia",
              "ADDRESS_LINE2": "Les Moneghetti",
              "ADDRESS_LINE3": "98000 Monaco",
              "MATCH_SCORE": "96"
            }
          },
          "ranges": [
            {
              "lowHouse": "14",
              "highHouse": "16",
              "side": "RIGHT",
              "oddEvenIndicator": "EVEN",
              "units": []
            }
          ]
        }
      ],
      "customValues": {
        "PARSED_INPUT_AREA_NAME_3": "MONACO",
        "PARSED_INPUT_POST_CODE_1": "98000",
        "PARSED_INPUT_STREET_NAME": "LOUIS AUREGLIA",
        "PARSED_INPUT_ADDRESS_NUMBER": "16",
        "PARSED_INPUT_COUNTRY": "MCO",
        "PARSED_INPUT_STREET_PRE_TYPE": "RUE",
        "PARSED_INPUT_FORMATTEDINPUTSTREET": "16 RUE LOUIS AUREGLIA"
      }
    }
  ]
}