Express Entry:GlobalExpressFreeForm
GlobalExpressFreeForm
The GlobalExpressFreeForm service is provided as a means of retrieving all available address elements using a free form search. GlobalExpressFreeForm returns FormattedAddress, AddressLine1-8, CountryISO3166_1_Alpha2, CountryISO3166_1_Alpha3, CountryISO3166_1_Numeric, SubNationalArea, PremisesNumber, AdministrativeArea, SubadministrativeArea, locality, dependentlocality, doubledependentlocality, thoroughfare, dependentthoroughfare, building, postalcode, and postbox.
Example Call
http://expressentry.melissadata.net/web/GlobalExpressFreeForm?format={FORMAT}&id={ID}&ff={FF}&country={COUNTRY}&maxrecords={MAXRECORDS}&nativecharset={true|false}
Requested Field Input Description Format {XML, JSON} The return format of the request. ID Text The License Key or token FF Text The Free Form request. Country Text The ISO2Code or country name of the address (required, Default US). Maxrecords Number The maximum number of records to return (required). Nativecharset True/False/Blank Optional. Return results in the native character set for the country.
Schema
- ?format=
- The response will be formatted according to the value set here.
- Valid values are: XML and JSON.
- &id=
- The ID element can contain your user ID, a complete License Key, or a token.
- &ff=
- The service uses this term to complete addresses in Free Form. If the search term exceeds seven characters, subsequent searches will use the allwords option. Also, if no results are found before the seven character limit, the allwords search is used.
- &country=
- The ISO2Code or full country name of the country to search (Default US).
- &maxrecords=
- Maxrecords is provided to control the number of results returned from a request to the service.
- &nativecharset=
- When set to true, return results in the native character set for the country. When set to false, return transliterated results in the Latin character set. When set to blank (‘&nativecharset=’) return results in the input character set.