C++ SDK

◆ LocationFromAddress()

static int CApplicationAPI::LocationFromAddress ( LpError  lpError,
LONGPOSITION cpLocation,
LPCTSTR  lpszAddress,
BOOL  bPostal,
BOOL  bValueMatch,
DWORD  dwMaxTime = DEFAULT_MAX_TIME 
)
static

The function returns location corresponding to taken address.

Parameters
lpErrorAdditional error information returned from Drive.
cpLocationLocation corresponding to taken address.
lpszAddressAddress in "ISO,city/ ZIP,street,house number" format. If address is in "ISO,city/ZIP,street,street" format, function will return coordinates of intersection.
bPostalFlag determining whether second address parameter represents city or ZIP code.
true - ZIP code.
false - City.
bValueMatchFlag determining whether the result will be the exact match or the best value match (true for fuzzy search of address)
dwMaxTimeMaximum time (in milliseconds) function can take. If dwMaxTime=0 function execution is not time limited.
Returns
1 if successful, other value otherwise.

Address parameter house number is optional. If you do not want to fill it write address like this:
"SVK,Bratislava,Einsteinova,"

Second address parameter can represent city name or ZIP code.

See Coordinates conversion section in TROUBLESHOOTING page.
The list of ISO codes can be found at http://userpage.chemie.fu-berlin.de/diverse/doc/ISO_3166.html.
ISO code of United States of America consists of character "U" plus code of state. E.g New York has ISO code UNY.
Indian states ISO codes can be found at http://devforum.sygic.com/viewtopic.php?f=15&t=2925&p=3646&hilit=I01&sid=354efb86bb92dc0dcdfcc1bb8d656c20#p3646

Possible error codes returned from Drive are:

  • 0 - Function not succeeded.
  • 1 - Function succeeded.
  • 2 - Drive not succeeded.
  • 3 - Function reached timeout.