◆ LocationFromAddressEx() [1/2]

static int LocationFromAddressEx ( out SError  Error,
string  strAddress,
bool  bPostal,
bool  bFuzzySearch,
out SWayPoint []  PositionArr,
Int32  MaxTime 

The function returns location corresponding to taken address.

ErrorAdditional error information returned from Drive.
strAddressAddress in "ISO,city/ ZIP,street,house number,extra city,extra street" format.
bPostalFlag determining whether second address parameter represents city or ZIP code.
true - ZIP code.
false - City.
bFuzzySearchFlag determining whether the result will be the exact match or the best value match (true for fuzzy search of address)
PositionArrArray of SWayPoint which contains retrieved items.
MaxTimeMaximum time (in milliseconds) function can take. If MaxTime=0 function execution is not time limited.
1 if successful, other value otherwise.

The function returns location corresponding to taken address. In some cases there can be more cities with the same name in one country or more streets with the some name in one city.

If there are more results corresponding to taken address LocationFromAddressEx stores the results into array of SWayPoint.

If you want to strictly specify address you can fill optional address parameters of address - extra city and extra street.

Extra city strictly defines region in country where city is situated. It should be set to province or canton of the country.
Extra street strictly defines part of city where street is situated so set this parameter to part of city.

LocationFromAddressEx function always fills extra city and extra street parts of address so if there are more results you can choose which one is that you meant.

If you do not want to fill optional street parameters make address like this:
Optional address paramters are extra city, extra street and house number.

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.

References SError.SizeOf().

Referenced by CApplicationAPI.LocationFromAddressEx().