Table of Contents

Search

  1. Preface
  2. Part 1: On-Prem Operations
  3. Part 2: Parameter and Element Reference
  4. Appendix A: JSON Schema
  5. Appendix B: Geocode Countries
  6. Appendix C: Certified Mode Values

Developer Guide

Developer Guide

Entering the Input Address Data

Entering the Input Address Data

To enter address data for verification, use the IDVE_PutJSON() function. The JSON function operates on JSON values. The values written and read must be a valid JSON document that matches the sub-schema of the given URI.
The following sample code shows the structure of the IDVE_PutJSON() function:
IDVE_EXPORTCALL1 IDVE_StatusCode IDVE_EXPORTCALL2
IDVE_PutJSON
( const char* const kpksCustomerID, const char* const kpksURI, const char* const kpksValue, const IDVE_U64 ku64ValueLength, const char* const kpksValueFilePath, char* const kpsExtStatusMsg );
You can also use the IDVE_PutString() function to enter the address. The PutString function operates on string values. The structure of the IDVE_PutString() function is similar to the IDVE_PutJSON() function, but IDVE_PutString() does not contain the
const char* const kpksValueFilePath
parameter in the structure. To use the IDVE_PutString() function, replace IDVE_PutJSON with IDVE_PutString in the structure and remove the
const char* const kpksValueFilePath
parameter from the structure.
The following table shows the parameter definitions for the IDVE_PutJSON() function:
Parameter
Operation
Comment
const char* const kpksCustomerID
[in]
Pointer to the zero-terminated 7-bit ASCII-encoded customer ID. The value might not be NULL.
const char* const kpksURI
[in]
Pointer to the zero-terminated 7-bit ASCII URI, for example "
AV/v1/Jobs/0/IO/Outputs/3/Results/0/Result/AddressElements/Street/1/Value
". The value might not be NULL.
const char* const kpksValue
[in]
Pointer to the UTF-8-encoded string value.
For the process command, the string can contain an input address in JSON format or can be NULL. The value must be NULL if the kpksValueFilePath is not NULL.
const IDVE_U64 ku64ValueLength
[in]
Length of the string value in number of code units, excluding any terminating zero. The value can be string length or IDVE_AUTOLEN. Ignored if kpksValue is NULL.
const char* const kpksValueFilePath
[in]
Pointer to the file path which refers to a JSON-formatted file to use as the value, encoded as UTF-8 or UTF-16. For the process command, the path identifies a file that contains the set of addresses that the job will process.
The value must be NULL if kpksValue is not NULL.
char* const kpsExtStatusMsg
[out]
Pointer to a buffer of size IDVE_EXT_STATUS_MSG_BUFFER_SIZE for an optional extended status message. The value can be NULL.