Places

Owned by Dmitry Cherednikov (Unlicensed)
Last updated: Oct 24, 2016
2 min read

Navmii SDK provides a set of classes responsible for representation of addresses an places of interest (POIs). The most basic classes to represent geographical entities are NMCity, NMState and NMCountry. NMCity contains the following information on a city:

  • name
  • transliterated name
  • city class (a NSInteger taking values from -1 to 15 and representing the size of the city)
  • if the city is a capital
NSLog(@"city name - %@", city.name);
NSLog(@"transliterated city name - %@, city.transliteratedName");
NSLog(@"city class - %d", (int)city.cityClass);
NSLog(@"is capital - %d", (int)city.isCapital);

You can retrieve a state's

  • code
  • name

from NMState.

NSLog(@"state name %@", state.name);
NSLog(@"state code %@", state.code);

And from NMCountry you can fetch:

  • ISO 3 Code
  • name
  • extended info

Extended info for a NMCountry is a NMCountryInfoExtended instance containing in its turn the following information:

  • country's speed units
  • country's distance units
  • country's driving side
NSLog(@"country ISO 3 code - %@", country.iso3Code);
NSLog(@"country name - %@", country.name);
NSLog(@"country speed units - %d", country.extendedInfo.speedUnits);
NSLog(@"country distance units - %d", country.extendedInfo.distanceUnits);
NSLog(@"country driving side - %d", country.extendedInfo.drivingSide);

ADDRESSES

The NMCity, NMState and NMCountry classes are aggregated into NMAddress class. The NMAddress also provides:

  • county name
  • administrative hierarchy
  • street name
  • route number
  • house number
NSLog(@"county name - %@", address.country.name);
NSLog(@"state name - %@", address.state.name);
NSLog(@"county name - %@", address.county);
NSLog(@"city name - %@", address.state.name);
NSLog(@"administrative hierarchy - %@", address.adminHierarchy);
NSLog(@"street name - %@", address.street);
NSLog(@"route number - %@", address.routeNumber);
NSLog(@"house number - %@", address.houseNumber);

PLACES OF INTEREST

When working with Navmii SDK search services you will also meet NMPlace instances. They represent places of interest (POIs). A NMPlace instance can provide you with the following info:

  • POI's name
  • place type
  • geographical location
  • POI's address
  • a BOOL value indicating if the address is approximated
  • POI data

POI data for a particular place is a NMPoiData instance containing a NSInteger indicating the place's primary category number and a NSArray with numbers of all categories associated with the place.

NSLog(@"place name - %@", place.name);
NSLog(@"place type - %d", place.type);
NSLog(@"coordinates - %f lat, %f lon", place.coordinates.latitude, place.coordinates.longitude);
NSLog(@"address - %@, %@", place.address.street, place.address.houseNumber);
NSLog(@"is adress approximated - %d", place.isAddressApproximated);
NSLog(@"POI category - %d", place.poiData.primaryCategory);
//logs out all categories associated with the POI
for (NSNumber *category in place.poiData.categories) {
	NSLog("POI belongs to category %d", [category intValue]);
}