APIs of NAC Real-Time Geo-Services Suite
for Web Applications

Real-Time Geocoding, Reverse Geocoding, Mapping, Driving Directions,
Location Based Searching and Real-Time Traffic Information Services
(http://mlbs.net/nacgeoservices/geoservices.asmx)

NAC Read-Time Geo-Services Suite provides real-time geocoding, reverse geocoding, mapping, driving directions, location based searching and real-time traffic information services. Here are the APIs for these services:
  1. API for Real-Time Geocoding Service
  2. API for Real-Time Reverse Geocoding Service
  3. API for Map and Mapping Service
  4. API for Driving Directions Service
  5. API for Location Based Searching Service
  6. API for Traffic Information Service
This is the API document for the services delivered as an XML Web Service. The services are also delivered using simple http get/html response model as shown in that API document.

API for NAC Real-time Geocoding Service

The real-time geocoding service is a web based geocoding service providing real-time geocoding of addresses from 24 countries and areas:

Australia, Austria, Belgium, Brazil, Canada, Denmark, Finland (Uusimaa, Häme and Pirkanmaa regions only), France, Germany, Greece (Athens only), Hong Kong, Italy, Luxembourg, Netherlands, New Zealand, Norway, Portugal, Singapore, Spain, Sweden, Switzerland, Taiwan, United Kingdom, and United States.

It is designed for Internet and web applications. This service is delivered as a method of an XML web service and controled by user id and exclusive user IP address.

Geocode

Input parameters:

Response

The response will include the following parameters:




API for Reverse Geocoding Service

The reverse geocoding is to provide the closest addresses of a given pair of longitude/latitude coordinates in 24 countries and areas:

Australia, Austria, Belgium, Brazil, Canada, Denmark, Finland (Uusimaa, Häme and Pirkanmaa regions only), France, Germany, Greece (Athens only), Hong Kong, Italy, Luxembourg, Netherlands, New Zealand, Norway, Portugal, Singapore, Spain, Sweden, Switzerland, Taiwan, United Kingdom, and United States

and the geographic entities of a given pair of longitude/latitude coordinates in the world.

GetLocationInfo

Input parameters:

Response

The response will include the following parameters:




API for Map and Mapping Service

All maps retrieved from NAC Real-Time Geo-Services should not be stored in any media, and can be displayed only once in real time. Since the retrieved maps will be shown to end users, any page showing the map must include the following items:
  1. A hyperlink of "A service provided by NAC Geographic Products Inc." to "http://www.nacgeo.com".
  2. A text of "Featuring Microsoft MapPoint Technology"
  3. A hyperlink of "Terms of Use" to "http://www.microsoft.com/mappoint/net/terms"
  4. A Hyperlink of "Privacy Statement" to "http://www.microsoft.com/mappoint/net/privacy"
The map and mapping services are also part of the XML web service and each mapping request costs the same as geocoding an address.

The mapping services provide a variety of maps and allow you to map up to 100 objects onto each map with a choice of street maps of 38 countries and areas:

Andorra, Australia, Austria, Belgium, Brazil, Canada, Czech Republic, Denmark, Finland, France, Germany, Gibraltar, Greece (athens only), Guernsey, Hong Kong, Ireland, Isle of Man, Italy, Jersey, Liechtenstein, Luxembourg, Mexico, Monaco, Netherlands, New Zealand, Norway, Portugal, Puerto Rico, San Marino, Singapore, Slovakia, Spain, Sweden, Switzerland, Taiwan, United Kingdom, United States, and Vatican City.

and 34 cities of other countries:

Bangkok, Thailand; Beijing, China; Bogota, Colombia; Budapest, Hungary; Buenos Aires, Argentina; Cairo, Egypt; Calcutta, India; Charlotte Amalie, U.S. Virgin Islands; Delhi, India; Ho Chi Minh City, Vietnam; Istanbul, Turkey; Jakarta, Indonesia; Jerusalem, Israel; Johannesburg, South Africa; Kingston, Jamaica; Kinshasha, Congo; Kuala Lumpur, Malaysia; Kyoto, Japan; Lagos, Nigeria; Lima, Peru; Manila, Philippines; Moscow, Russia; Nairobi, Kenya; Nassau, Bahamas; Osaka, Japan; San Jose, Costa Rica; Santiago, Chile; Santo Domingo, Dominican Republic; Seoul, South Korea; Shanghai China; Tehran, Iran; Tel Aviv, Israel; Tokyo, Japan; and Warsaw, Poland;

and general thematic maps of the entire world.

There are two methods supported in getting a map:
  1. Get Map Defined by Its Center, Northing and Easting Spans
  2. Get Map Defined by its Bounding Ranctangle (Southwest lon/lat and Northeast lon/lat)

Get Map by Its Center, Northing and Easting Spans

GetMap

GetMapEx

Input parameters:


Map Style Description MapPoint.AP
MapPoint.BR
MapPoint.EU
MapPoint.NA
MapPoint.World MapPoint.Moon
Climate Characteristic climate for areas on the Earth, defined by long-term weather patterns. Color.
 
x
 
Comprehensive For the MapPoint.World data source, contains several categories of information for purposes of general reference, including topographic, political, and geographic information. Color.

For the MapPoint.Moon data source, contains views of the moon as a composite of satellite images, including identification of craters, landing sites, and lunar seas. Color.

 
default
default
DefaultStyle Default map style for a data source.
x
x
x
EarthByDay Idealized map of the Earth as it looks from space in daylight without clouds, as a composite of satellite images. Color.
 
x
 
EarthByNight Idealized map of the Earth as it looks from space at night without clouds, as a composite of satellite images. Color.
 
x
 
Ecoregions Landscapes, such as forests, woodlands, grasslands, deserts, and ice. Color.
 
x
 
Languages Language spoken by a majority of people in an area. Color.
 
x
 
Locator Roads and some political geographies, optimized for overview maps. Color.
x
 
 
LocatorBW Roads and some political geographies, optimized for overview maps. High contrast for black and white printing.
x
 
 
Night Roads and some political geographies, optimized for low-light viewing.
x
 
 
Outline Current borders of the world's sovereign nations and their dependencies, and at higher resolutions, borders between states, provinces, or other internal subdivisions. Also indicated are names and locations of selected cities and towns; rivers, lakes, and seas; and mountains, plateaus, deserts, and other physical features. Color.
 
x
 
Parks Significant protected areas, such as World Heritage Sites; national, provincial, and state parks; other major reserves; and territories reserved for indigenous peoples in the Americas. Color.
 
x
 
Phone Shows roads and political geographies, optimized for small screens (size ranges from 101 × 80 pixels to 176 × 220 pixels). Color.
x
 
 
PhoneBW Shows roads and political geographies, optimized for small screens (size ranges from 101 × 80 pixels to 176 × 220 pixels). High contrast for black and white printing.
x
 
 
PhysicalFeatures Landforms and water bodies. Color.
 
x
 
Political Political geography; political entities are shown in contrasting colors for emphasis. Color.
x
x
 
PoliticalBW Political geography; political entities are shown in outline. High contrast for black and white printing.
x
 
 
PopulationDensity Number of people per square kilometer throughout the world. Color.
 
x
 
PrecipitationAnnual Average accumulation of rain or snow over an entire year. Color.
 
x
 
PrecipitationJanuary Average accumulation of rain or snow during the month of January. Color.
 
x
 
PrecipitationJuly Average accumulation of rain or snow during the month of July. Color.
 
x
 
Religions Distribution of the adherents of the world's major regions. Color.
 
x
 
Road Roads, highways, towns, and cities. Color.
x
 
 
RoadBW Roads, highways, towns, and cities. High contrast for black and white printing.
x
 
 
Small Roads and political geographies, optimized for low resolution maps. Color.
default
 
 
SmallBW Roads and political geographies, optimized for low resolution maps. High contrast for black and white printing.
x
 
 
Tectonic Distribution of plates that make up the Earth's crust, location of volcanoes and earthquakes, and age of the floor beneath the seas. Color.
 
x
 
TemperatureJanuary Average air temperature during the month of January. Color.
 
x
 
TemperatureJuly Average air temperature during the month of July. Color.
 
x
 
Terrain Roads, highways, towns, cities, and geographic terrain. Color.
x
 
 
TerrainBW Roads, highways, towns, cities, and geographic terrain. High contrast for black and white printing.
x
 
 
TimeZones Zones of uniform time recognized by national agreement. Color.
 
x
 

Response

The response will include the following parameters:

Get Map by Its Bounding Rectangle

GetMapbybr

GetMapbybrEx

Input parameters:

Response

The response will include the following parameters:




API for Driving Directions Service

All maps retrieved from NAC Real-Time Geo-Services should not be stored in any media, and can be displayed only once in real time. Since the retrieved maps will be shown to end users, any page showing the map must include the following items:
  1. A hyperlink of "A service provided by NAC Geographic Products Inc." to "http://www.nacgeo.com".
  2. A text of "Featuring Microsoft MapPoint Technology"
  3. A hyperlink of "Terms of Use" to "http://www.microsoft.com/mappoint/net/terms"
  4. A Hyperlink of "Privacy Statement" to "http://www.microsoft.com/mappoint/net/privacy"
This service is part of the XML web service to provide driving directions and route maps for 34 countries and areas:

Andorra, Australia, Austria, Belgium, Brazil, Canada, Czech Republic, Denmark, Finland, France, Germany, Greece (athens only), Hong Kong, Ireland, Italy, Liechtenstein, Luxembourg, Mexico, Monaco, New Zealand, Netherlands, Norway, Portugal, Puerto Rico, San Marino, Singapore, Slovania, Spain, Sweden, Switzerland, Taiwan, United Kingdom, United States, and Vatican City.

The costs for these services are:

GetDirections

GetDirectionsmp

GetDirectionsEx

GetDirectionsmpEx

The input parameters are:

Response

The response parameters are:




API for Location Based Business Searching

All maps and the information of business entities retrieved from NAC Real-Time Geo-Services should not be stored in any media, and can be displayed only once in real time. Since the retrieved maps will be shown to end users, any page showing the map must include the following items:
  1. A hyperlink of "A service provided by NAC Geographic Products Inc." to "http://www.nacgeo.com".
  2. A text of "Featuring Microsoft MapPoint Technology"
  3. A hyperlink of "Terms of Use" to "http://www.microsoft.com/mappoint/net/terms"
  4. A Hyperlink of "Privacy Statement" to "http://www.microsoft.com/mappoint/net/privacy"
This service is a part of the XML web service to provide location based searches for Canada, United States and major cities in Europe.

The costs of this service are:
  1. Getting a list of found items costs the same as geocoding one address
  2. Getting both a list of found items and the map displaying found idems costs the same as geocoding two addresses.

Search

SearchEx

The input parameters are:

Response

The response parameters are:

API for Traffic Information Service

All maps retrieved from NAC Real-Time Geo-Services should not be stored in any media, and can be displayed only once in real time. Since the retrieved maps will be shown to end users, any page showing the map must include the following items:
  1. A hyperlink of "A service provided by NAC Geographic Products Inc." to "http://www.nacgeo.com".
  2. A text of "Featuring Microsoft MapPoint Technology"
  3. A hyperlink of "Terms of Use" to "http://www.microsoft.com/mappoint/net/terms"
  4. A Hyperlink of "Privacy Statement" to "http://www.microsoft.com/mappoint/net/privacy"
This service is a part of the XML web service to provide traffic information. Currently, it provides traffic information only for major metropolitan areas in the United States.

The costs of this service are:
  1. Getting a list of traffic incidents costs the same as geocoding one address
  2. Getting both a list of traffic incidents and the map displaying the incidents costs the same as geocoding two addresses.

GetTrafficInfo

GetTrafficInfoEx

The input parameters are:

Response

The response parameters are:

Here is the explanation of the parameters of incidents: