Telenav Developer Community: HTML5 Navigation and premium navigation APIs for mobile developers

DEVELOPERS

Creating a Simple Android Telenav Connect Client using the Adapter

The Android platform offers develoers capabilities to create components and a framework to handle messaging between these components. Intent based programming basically achieves this goal with intents being the messages and Activities being the components. This paradigm hence offers a simple service-oriented application model architecture. The following sample is the recommended apporach for integration with the navigator using Telenav Connect. The adavantages of using the adapter is that it provides validation of the parameters being sent over the Telenav Connect URI. Use the MaiTaiAdapterFactory to create an instance of the adapter. As an Android pp developer you may need to offer navigation based on some interactions from the user on the Android view and hence you could invoke the launchMaiTai() function from the vent handlers for the view.

			 
public SimpleActivity  extends Activity  implements IMaiTaiAdapterCallback {
private IMaiTaiAdapter adapter;


protected void onCreate(Bundle savedInstanceState) {
	...				
	MaiTaiContext context = new MaiTaiContext(this,this);  // android activity context, callback instance
	adapter = (MaiTaiAdapter)MaiTaiAdapterFactory.createInstance(context);
	....
}


.....

private void launchMaiTai(String action, Map map)
{
	StringBuffer request = new StringBuffer();
	request.append("telenav://" + action + "?");
	map.put(MAITAIConstants.KEY_VERSION, "1.0");
	map.put(MAITAIConstants.KEY_CONTEXT, "cn");
	map.put(MAITAIConstants.KEY_DEVELOPER_KEY, "<YOUR API KEY>");

	Set<Map.Entry<String,String>> set = map.entrySet();
	Iterator<Map.Entry<String,String>> i = set.iterator();
	while (i.hasNext())
	{
	    Map.Entry<String, String> me = (Map.Entry<String, String>)i.next();
	    try
	    {
		String key = me.getKey();
		key = URLEncoder.encode(key, "UTF-8");
		String val = me.getValue();
		val = URLEncoder.encode(val, "UTF-8");
		String pair = key + "=" + val;
		request.append(pair);
		if (i.hasNext()) request.append("&");
	    }
	    catch(Exception e)
	    {}
	}

	System.out.println("maitai request = " + request.toString());
	adapter.request(request.toString());
}
}

Creating a Simple Android Maitai Client without Adapter

The following sample is an alternative way to perform an integration. With this method if a callback is needed then the application must register as a listener for a new intent and provide the intent via the "cb" parameter.

		
	private void launchMaiTai(String action, Map map)
	{
	
		StringBuffer request = new StringBuffer();
		request.append("telenav://" + action + "?");
	
		map.put(MAITAIConstants.KEY_VERSION, "1.0");
		map.put(MAITAIConstants.KEY_CONTEXT, "cn");
		map.put(MAITAIConstants.KEY_DEVELOPER_KEY, "YOUR API KEY");
	
		Set<Map.Entry<String,String>> set = map.entrySet();
		Iterator<Map.Entry<String,String>> i = set.iterator();
		while (i.hasNext())
		{
		    Map.Entry<String, String> me = (Map.Entry<String, String>)i.next();
		    try
		    {
			String key = me.getKey();
			key = URLEncoder.encode(key, "UTF-8");
			String val = me.getValue();
			val = URLEncoder.encode(val, "UTF-8");
			String pair = key + "=" + val;
			request.append(pair);
			if (i.hasNext()) request.append("&");
		    }
		    catch(Exception e)
		    {}
		}
	
		System.out.println("maitai request = " + request.toString());
		Intent intent = new Intent(Intent.ACTION_VIEW);
		intent.setData(Uri.parse(request.toString()));
		startActivity(intent);
	}

Running the Telenav Sample

This section describes the process to getting started with Telenav Connect and integrating the navigation experience within your application.

#Step 1 : 
	Download and install the samples & adapter code.After running the  TN Android samples the following menu
	is displayed.

 #Step 2 : 
				Click on "navTo" in this case. The activity screen will require your inputs for the destination.

Telenav Connect
API Documentation
- Map
- NavTo
- Directions
- Search
- Error Codes
Platform Documentation

<div class="telenavLink"><a href="http://www.telenav.com"><img alt="Telenav" src="sdkweb/scout/image/breadcrumb_logo.png"></a></div>
		{if app == 'scout' && curfunction == 'scoutBtn'}
				 <div class="navItem grayText"><a href="javascript:void(0)">Scout Drive Button</a></div>
        {else}
		<div class="navItem grayText"><a href="http://developer.telenav.com:80/sdkweb">Telenav Developers</a></div>
		{/if}
			{if app=='home'}
				{if page != 'home'}
					{if page == 'myaccount' ||page == 'password'||page == 'keys'}
				 	<div class="breadcrumbArrow"><img alt="Telenav" src="sdkweb/scout/image/breadcrumb_arrow.png"></div>
				 	<div class="navItem grayText"><a href="javascript:void(0)">Account</a></div>
				 	{/if}
					<div class="breadcrumbArrow"><img alt="Telenav" src="sdkweb/scout/image/breadcrumb_arrow.png"></div>
					<div class="navItem grayText"><a href="javascript:void(0)">
					{if page == 'apis'}APIs
					{elseif page == 'support'}Support
					{elseif page == 'myaccount'}My Account
					{elseif page == 'password'}Password
					{elseif page == 'keys'}API Keys
					{elseif page == 'login'}Log In
					{elseif page == 'join'}Join
					{elseif page == 'reset_password'}Reset Password
					{else}${page}
					{/if}
					</a></div>
				{/if}
			{/if}
			{if app!='home' && curfunction != 'scoutBtn'}
                {if page == 'apis'}
                    <div class="breadcrumbArrow"><img alt="Telenav" src="sdkweb/scout/image/breadcrumb_arrow.png"></div>
                    <div class="navItem grayText"><a href="dispatch.do?page=apis">APIs</a></div>
                {/if}
                
				<div class="breadcrumbArrow"><img alt="Telenav" src="sdkweb/scout/image/breadcrumb_arrow.png"></div>
				<div class="navItem grayText"><a href="maitai?app=maitai">
				     {if app == 'maitai'}Telenav Connect
				     {elseif app == 'scout'}Scout for Apps
				     {elseif app == 'share'}Telenav Share
				     {else}${app}
				     {/if}
				</a></div>
				
				{if page_current == 'home' ||app=='scout'}
				{elseif page_current == 'api' || page_current == 'platformdocs'}
				<div class="breadcrumbArrow"><img alt="Telenav" src="sdkweb/scout/image/breadcrumb_arrow.png"></div>
			    <div class="navItem grayText"><a href="scout?app=maitai&page=home">Documentation</a></div>
			    {else}
	         	<div class="breadcrumbArrow"><img alt="Telenav" src="sdkweb/scout/image/breadcrumb_arrow.png"></div>
	         	<div class="navItem grayText"><a href="scout?app=maitai&page=home">home</a></div>
			    {/if}
			    {if app != 'scout'}
			 	<div class="breadcrumbArrow"><img alt="Telenav" src="sdkweb/scout/image/breadcrumb_arrow.png"></div>
		 	    <div class="navItem grayText"><a href="javascript:void(0)">
		 	        {if app == 'geocoding'}
					 	{if curfunction == 'helloWorld'}My First Call
					 	{elseif curfunction == 'throttle'}Limit of Use
					 	{else}${curfunction}
					 	{/if}
		 	         {/if}
		 	        {if app == 'maitai'}
		 	        	{if curfunction == 'map'}Map API
		 	        	{elseif curfunction == 'navTo'}NavTo API
		 	        	{elseif curfunction == 'directions'}Directions API
		 	        	{elseif curfunction == 'search'}Search API
		 	        	{elseif curfunction == 'errorCodes'}Error Codes API
		 	        	{elseif curfunction == 'android'}Android Platform
		 	        	{elseif curfunction == 'rim'}RIM Platform
		 	        	{elseif curfunction == 'brew'}BREW Platform
		 	        	{else}${curfunction}
		 	            {/if}
                     {/if}
                     {if app == 'share'}
                            {if curfunction == 'login'}Login API
                            {elseif curfunction == 'shareAddress'}Share Address API
                            {elseif curfunction == 'sendToPhone'}Send To Phone API
                            {else}${curfunction}
                            {/if}
                     {/if}</a>
				</div>
				{/if}
			{/if}

First Name *

Last Name *

Company *

Title/Role *

Email *

Phone *

Password *

Confirm Password *

Select Product(s) of Interest *
Scout for Apps Telenav Connect Telenav Share
How do you intend to use this API(s)? *

How did you hear about us?

Please Specify:

Log In

ACCESS THE DEVELOPER NETWORK

Log in with your username and password to:

Join the Telenav developer community

Register as a member to: