Traçando rotas no Android com a Google Directions

Por que eu devo ler este artigo:

O advento e populariza��o da computa��o m�vel, atrav�s de smartphones e tablets, trouxe consigo a demanda por aplica��es de geolocaliza��o. Quer seja para saber o caminho mais curto entre um ponto e outro ou localizar a pizzaria mais pr�xima de casa, a orienta��o e navega��o atrav�s de mapas vem se tornando um item cada vez mais presente em nosso dia a dia.

Esse artigo tem como objetivo apresentar a integra��o da API do Google em dispositivos rodando o sistema operacional Android. A realiza��o dessa integra��o ser� demonstrada atrav�s de um exemplo simples onde ser� implementada uma rota de navega��o atrav�s de um ponto de origem e destino informados pelo usu�rio utilizando a API do Google para geolocaliza��o, a Google Directions API.

O termo geolocaliza��o refere-se � identifica��o da localiza��o geogr�fica no mundo real de um objeto, como um radar, telefone celular ou terminal de computador conectado � Internet.

Na computa��o, um software de geolocaliza��o � usado para deduzir a localiza��o geogr�fica de dispositivo conectado � Internet, usando como uma das abordagens poss�veis a identifica��o pelo n�mero IP do dispositivo, para finalmente chegar � sua localiza��o.

Os servi�os baseados em geolocaliza��o (SLBL�S) geralmente s�o divididos em duas categorias principais: servi�os �push� e servi�os �pull�. Servi�os push implicam que um usu�rio recebe informa��o (em fun��o de sua localiza��o) sem ter que requisit�-la ativamente. Um exemplo pr�tico seria o envio de uma notifica��o de ofertas de um estabelecimento comercial do qual o usu�rio est� se aproximando.

No caso de servi�os pull, a informa��o s� � enviada ao usu�rio caso este a requisite explicitamente. Um exemplo seria no caso do usu�rio desejar saber onde se encontra o restaurante mais pr�ximo.

A geolocaliza��o abre um vasto nicho de aplica��es a serem exploradas, tais como:

Servi�os de Informa��o: Os servi�os desta categoria fornecem instru��es de como se chegar a um destino desejado, indicam onde encontrar um determinado servi�o ou pessoa nas redondezas, ou localizam um usu�rio perdido em um mapa;
Servi�os de Emerg�ncia: Em situa��es de emerg�ncias, o fator tempo normalmente � determinante para se evitar consequ�ncias mais graves. O uso de tecnologias de localiza��o possibilita um menor tempo de resposta, desde o instante em que ocorre o fato em quest�o at� o momento em que chega o aux�lio. As aplica��es mais claras desta categoria seriam na �rea m�dica e na �rea de seguran�a. Pessoas idosas ou com algum tipo de doen�a poderiam ter seus sinais vitais monitorados por dispositivos m�veis, e estes automaticamente emitiriam um sinal de alerta no caso de alguma anomalia ser detectada. No caso de aplica��es de seguran�a, esse sinal poderia ser disparado por iniciativa do usu�rio ou em decorr�ncia de algum evento suspeito. O sinal emitido indicaria a localiza��o do usu�rio e equipes de socorro seriam deslocadas at� o local;
Servi�os de Rastreamento: Um exemplo claro de aplica��o desta categoria � o rastreamento de frotas de ve�culos transportando mercadorias. � poss�vel monitorar todo o percurso de cada ve�culo e identificar comportamentos suspeitos no caso de mudan�as de itiner�rio n�o previstas. Essa aplica��o � particularmente �til para seguradoras, pois aumenta as chances de se encontrar os ve�culos em caso de sinistro;
Servi�os de Dissemina��o de Informa��o: Um exemplo pr�tico seria a dissemina��o de propagandas. Anunciantes poderiam enviar mensagens de promo��es tempor�rias a clientes potenciais que estejam nas redondezas de seu estabelecimento, e um novo tipo personalizado de B2C (Business to Consumer) se estabeleceria de forma din�mica e localizada, aumentando tremendamente a efici�ncia dos an�ncios e o potencial de venda. Um exemplo pr�tico seria um restaurante oferecendo ofertas de refei��es para pessoas caminhando pela vizinhan�a durante o hor�rio de almo�o.

Obtendo a localiza��o de um objeto

Existem basicamente duas formas de se obter a localiza��o geogr�fica de um objeto: por GPS e pela triangula��o de antenas.

GPS

Nos rastreadores usando GPS, o aparelho embarcado determina sua pr�pria posi��o ap�s conectar-se a pelo menos quatro sat�lites de uma constela��o de sat�lites americanos. Com os dados recebidos, o equipamento rastreador pode calcular a sua posi��o, e por consequ�ncia a posi��o do ve�culo em que est� embarcado.

Ap�s isso, ele deve enviar esse dado para uma central, que ir� mostrar graficamente a localiza��o do ve�culo. Esse envio pode ser feito via celular (geralmente via GPRS) ou via sat�lite. Para envio via sat�lite na comunica��o com as unidades em terra, o sat�lite envia a posi��o do ve�culo a uma esta��o de comunica��o que por sua vez envia as esta��es intermedi�rias, servidores, ou mesmo diretamente aos computadores, possibilitando a localiza��o dos ve�culos.

� poss�vel tamb�m a comunica��o inversa, tanto no rastreador via GPRS Celular quanto no localizado no sat�lite. No caso do rastreador satelital, por exemplo, � poss�vel o envio de comandos como: um bloqueio, onde o comando partiria de um computador, seguiria at� a esta��o terrena do sat�lite, em seguida passaria pelo sat�lite em �rbita e chegaria at� o ve�culo bloqueando-o.

Triangula��o de Antenas

No sistema de rastreamento por triangula��o de antenas, uma rede de r�dio � montada exclusivamente para esse fim. As antenas recebem o sinal de r�dio de um equipamento instalado no ve�culo e, com base nesse sinal e na posi��o conhecida das antenas, calcula-se a posi��o do ve�culo. N�o h� necessidade nesse caso de um segundo meio para envio da informa��o de posi��o como no caso do GPS. Tudo � feito via a pr�pria rede de r�dio montada para o servi�o.

Diversas empresas que trabalham com frotas de ve�culos tamb�m j� aderiram ao aparelho de rastreador que, al�m de usados para garantir maior seguran�a, pode ser utilizado como fonte de informa��es mais espec�ficas. Assim como no caso do o rastreamento dos ve�culos, � poss�vel calcular o tempo de uma determinada entrega.

Exemplo de aplica��es de geolocaliza��o

Find Friend

Desenvolvido pela AT&T e dispon�vel comercialmente em algumas cidades nos EUA, o Find Friend, como o nome sugere, � uma aplica��o para aproxima��o de pessoas. Ele permite que um usu�rio localize pessoas (previamente cadastradas) e marque encontros com elas. A aplica��o pode ainda sugerir pontos de encontros como restaurantes, e dire��es � com aux�lio de mapas � para chegar ao local combinado.

Waze

Waze � um aplicativo GPS baseado em navega��o geogr�fica programado para smartphones que prov� informa��es em tempo real e informa��es de usu�rios e detalhes da rota, baixando informa��o dependendo da localiza��o do dispositivo port�til na rede. Foi desenvolvido pela startup israelense Waze Mobile, que foi adquirida pelo Google em 2013. As pessoas podem relatar acidentes, congestionamentos, velocidade, 'blitzes' policiais, e podem atualizar rodovias, pontos de refer�ncia, n�meros de casas, etc. O Waze tamb�m identifica os postos de gasolina mais baratos perto do usu�rio atrav�s de sua rota. Em janeiro de 2012, o aplicativo j� havia sido baixado 12 milh�es de vezes no mundo. Em julho de 2012 o Waze anunciou que havia chegado aos 20 milh�es de usu�rios, metade deles recrutados nos �ltimos 6 meses. De acordo com o Yahoo!, existiam cerca de 50 milh�es de usu�rios do Waze em junho de 2013.

Vis�o geral da Google Directions AP

Em junho de 2005, o Google lan�ou a Google Maps API, uma plataforma que permite ao desenvolvedor integrar o Google Maps em seus aplicativos. Utilizando essa API, torna-se poss�vel embutir mapas do Google Maps em aplicativos web.

A Google Directions API � uma plataforma oferecida pelo Google que permite o c�lculo de rotas a partir de um ponto de origem e destino atrav�s de uma requisi��o HTTP e a exibi��o do mapa utilizando o Google Maps.

Limites de uso

O uso da Google Directions API est� sujeito a um limite de consultas de 2.500 solicita��es de rotas por dia. Cada pesquisa de rotas conta como uma �nica solicita��o em sua cota di�ria quando o modo de transporte for dirigir, andar a p� ou de bicicleta. A pesquisa de rotas com transporte p�blico ser� contada como quatro solicita��es.

As solicita��es individuais para rotas de carro, a p� ou de bicicleta podem conter at� oito pontos de refer�ncia intermedi�rios na solicita��o. Clientes da API do Google Maps para Empresas podem consultar at� 100.000 solicita��es de rotas por dia, com at� 23 pontos de refer�ncia permitidos em cada solicita��o. Os pontos de refer�ncia n�o est�o dispon�veis para rotas com transporte p�blico.

Al�m disso, as URLs da Google Directions API est�o limitadas a 2.048 caracteres, antes da codifica��o do URL. Como algumas URLs do servi�o da Google Directions API podem envolver muitos locais ao longo de um caminho, leve em conta esse limite ao criar URLs.

Criando uma aplica��o usando a Google Directions API

Para criar uma aplica��o utilizando a Google Directions API, � necess�rio a obten��o de uma chave de acesso que dever� ser incorporada � aplica��o que pretende fazer o uso dos dados da API. A obten��o da chave � feita de forma totalmente gratuita e foi explicada detalhadamente no artigo �Geolocaliza��o Android: GPS, mapas e sintetiza��o de voz no Android� publicado na revista Mobile Magazine Edi��o 57, bem como as configura��es iniciais no aplicativo Android para a utiliza��o da API.

Para criar uma aplica��o Android utilizando a Google Directions API ser� utilizada a IDE Eclipse Kepler com o Android SDK e o plugin ADT.

Para criar um projeto Android, clique com o bot�o direito no Package Explorer e acesse a op��o New > Other > Android Application Project, como mostrado na Figura 1.

**Figura 1**. Criando um novo aplicativo Android

Criando a activity principal

No Android, o termo activity serve para designar uma tela que � mostrada ao usu�rio final, sendo essa tela composta de dois artefatos:

Um arquivo XML contendo o layout da tela propriamente dita;
Uma classe Java que controla o estado da activity.

O c�digo do layout do arquivo XML � mostrado na Listagem 1 e consiste de duas caixas de texto para entrada dos dados de origem e destino, respectivamente, e um bot�o para disparar a execu��o do desenho da rota. A tela inicial do aplicativo � mostrada na Figura 2.

**Figura 2**. Tela inicial do aplicativo

O componente raiz do arquivo � um componente do tipo LinearLayout com a propriedade android:orientation definida como �vertical�. Essa configura��o informa ao Android que os componentes ser�o posicionados um abaixo do outro.

                        
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
  android:layout_width="fill_parent"
  android:layout_height="wrap_content"
  android:orientation="vertical"
  android:padding="10dp" >
 
  <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="fill_parent"
    android:layout_height="0dp"
    android:layout_weight="3"
    android:orientation="horizontal" >
 
    <TextView
      android:text="Origem"
      android:layout_width="0dp"
      android:layout_weight="1"
      android:layout_height="wrap_content"
      android:textStyle="bold" />

    <EditText
      android:id="@+id/editOrigem"
      android:layout_width="0dp"
      android:layout_height="wrap_content"
      android:layout_weight="2"
      android:inputType="text"
      android:lines="1"
      android:maxLines="1" />
 
</LinearLayout>
 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
  android:layout_width="fill_parent"
  android:layout_height="0dp"
  android:layout_weight="3"
  android:orientation="horizontal" >

  <TextView
    android:text="Destino"
    android:layout_width="0dp"
    android:layout_weight="1"
    android:layout_height="wrap_content"
    android:textStyle="bold" />

  <EditText
    android:id="@+id/editDestino"
    android:layout_width="0dp"
    android:layout_height="wrap_content"
    android:layout_weight="2"
    android:inputType="text"
    android:lines="1"
    android:maxLines="1" />

</LinearLayout>

<Button
    android:id="@+id/btnTracar"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    android:text="Tra�ar" />

</LinearLayout>

Listagem 1. Activity principal do aplicativo

O c�digo da classe gerenciadora da Activity � mostrado na Listagem 2. Essa classe � respons�vel por recuperar os valores dos componentes definidos no arquivo de layout. � feita a valida��o dos campos de origem e destino, e caso os mesmos estejam corretamente preenchidos a navega��o ser� delegada para a classe MapActivity, respons�vel pela exibi��o do mapa.

A mudan�a de tela em um aplicativo Android � realizada utilizando um componente do tipo Intent. Um Intent � uma classe presente na API padr�o do Android que permite a navega��o entre activities, bem como a passagem de par�metros entre activities utilizando o m�todo putExtra().


import android.app.Activity;
import android.content.Intent;
import android.os.Bundle;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.EditText;
import android.widget.Toast;
 
public class MainActivity extends Activity {
      
  private EditText editOrigem;
  private EditText editDestino;
  private Button btnTracar;
 
  @Override
  protected void onCreate(final Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
   
    editOrigem = (EditText) findViewById(R.id.editOrigem);
    editDestino = (EditText) findViewById(R.id.editDestino);
    btnTracar = (Button) findViewById(R.id.btnTracar);

    btnTracar.setOnClickListener(new OnClickListener() {
      /**
      * {@inheritDoc}
      */
      @Override
      public void onClick(final View v) {
        if("".equals(editOrigem.getText().toString().trim())) {
          Toast.makeText(MainActivity.this, "Informe o ponto de partida", 
          Toast.LENGTH_SHORT).show();
        }
        else if("".equals(editDestino.getText().toString().trim())) {
          Toast.makeText(MainActivity.this, "Informe o ponto de destino", 
          Toast.LENGTH_SHORT).show();
        }
        else {
          final Intent intent = new Intent(MainActivity.this, MapActivity.class);
          intent.putExtra("ORIGEM", editOrigem.getText().toString().trim());
          intent.putExtra("DESTINO", editDestino.getText().toString().trim());

          MainActivity.this.startActivity(intent);
        }              
      }
    });
  }
}

Listagem 2. Activity Principal

Recuperando par�metros e mostrando o mapa

O c�digo da classe MapActivity � mostrado na Listagem 3. Essa classe � respons�vel por recuperar os valores de origem e destino atrav�s do m�todo getStringExtra(), bem como recuperar o fragmento definido na activity respons�vel pela exibi��o do mapa, mostrada na Listagem 4.


import android.app.Activity;
import android.os.Bundle;
import com.google.android.gms.maps.GoogleMap;
import com.google.android.gms.maps.MapFragment;
 
public class MapActivity extends Activity {
 private GoogleMap gMap;
   
 @Override
 protected void onCreate(final Bundle savedInstanceState) {
   super.onCreate(savedInstanceState);
   setContentView(R.layout.activity_map);

   gMap= ((MapFragment)getFragmentManager().findFragmentById(R.id.map)).getMap();

   final String editOrigem = getIntent().getStringExtra("ORIGEM");
   final String editDestino = getIntent().getStringExtra("DESTINO");

   new RotaTask(this, gMap, editOrigem, editDestino).execute();
 }
}

Listagem 3. Classe respons�vel por gerenciar a tela do mapa

<?xml version="1.0" encoding="utf-8"?>
<fragment xmlns:android="http://schemas.android.com/apk/res/android"
  android:id="@+id/map"
  android:layout_width="match_parent"
  android:layout_height="match_parent"
  android:name="com.google.android.gms.maps.MapFragment"/>

Listagem 4. Tela de layout para mapa

A tela de consulta de rotas � mostrada na Figura 3. O mapa com a rota tra�ada � demonstrado na Figura 4.

**Figura 3**. Consulta de rota pela API do Google Maps

**Figura 4**. Rota tra�ada no Google Maps

Utilizando Fragments e a classe MapFragment

A partir da sua vers�o 3.0, o Android incluiu em sua API a funcionalidade de fragments, que possibilita desenhar a interface com o usu�rio de forma mais din�mica e reutiliz�vel, com o objetivo de suportar diferentes tamanhos de tela.

Um exemplo de utiliza��o de fragments seria um aplicativo de not�cias. Em um tablet, ter�amos um fragment do lado esquerdo da tela contendo uma listagem de not�cias. Ao clicar em um item da lista, seria disponibilizado outro fragment do lado do primeiro contendo os detalhes da not�cia escolhida. Em um dispositivo de tamanho de tela menor como um celular, o fragment de detalhe da not�cia selecionada ocuparia o espa�o inteiro da tela, como esquematizado na Figura 5.

A forma mais simples de embutir um mapa em um aplicativo Android � criando um fragment do tipo MapFragment. A classe MapFragment � um tipo especial de view presente na API do Google Maps que funciona como um template para a renderiza��o do mapa na aplica��o.

A classe GoogleMap � respons�vel por gerenciar a apresenta��o do mapa na aplica��o. Nela encontramos os m�todos respons�veis por adicionar interatividade ao nosso mapa. Uma inst�ncia dessa classe � obtida atrav�s da chamada ao m�todo getMap() de um objeto da classe MapFragment presente na aplica��o.

Utilizando AsyncTasks

No Android, caso n�o seja especificado nenhum tipo de concorr�ncia, todo o c�digo ir� rodar na thread principal. Essa thread � conhecida como UI Thread, tamb�m chamada de main() thread.

Isso se torna um problema no caso da exist�ncia de processos que demorem muito tempo para serem executados, pois caso exista algum processamento que demore mais de cinco segundos a UI thread deixar� de responder e a aplica��o apresentar� um ANR (Application Not Responding) ao usu�rio.

Uma das maneiras de contornar esse problema � por meio da utiliza��o de AsyncTasks, que nada mais s�o do que objetos que encapsulam e tornam transparente ao desenvolvedor a utiliza��o de threads, permitindo ao desenvolvedor realizar opera��es em background sem que seja necess�rio conhecimento da API de Threads da plataforma Java.

No nosso exemplo, o c�digo respons�vel por enviar a requisi��o HTTP para a Google Directions API estar� encapsulado em uma AsyncTask, pois dado que esse � um processamento potencialmente custoso para a aplica��o, n�o corremos o risco de �travar� a thread principal do aplicativo esperando por uma resposta da API. O c�digo da classe AsyncTask � mostrado na Listagem 5.

//imports omitidos...
 
public class RotaTask extends AsyncTask<Void, Integer, Boolean> {
 
  private static final String TOAST_MSG = "Calculando";
  private static final String TOAST_ERR_MAJ = "Impossivel tra�ar Itiner�rio";
 
  private Context context;
  private GoogleMap gMap;
  private String editOrigem;
  private String editDestino;
  private final ArrayList<LatLng> lstLatLng = new ArrayList<LatLng>();
 
  public RotaTask(final Context context, final GoogleMap gMap, final String editOrigem, 
  final String editDestino) {
    this.context = context;
    this.gMap= gMap;
    this.editOrigem = editOrigem;
    this.editDestino = editDestino;
  }
 
  /**
  * {@inheritDoc}
  */
  @Override
    protected void onPreExecute() {
      Toast.makeText(context, TOAST_MSG, Toast.LENGTH_LONG).show();
  }
 
  /***
  * {@inheritDoc}
  */
  @Override
  protected Boolean doInBackground(Void... params) {
    try {
      final StringBuilder url = new StringBuilder
      ("http://maps.googleapis.com/maps/api/directions/xml?sensor=false&language=pt");
      url.append("&origin=");
      url.append(editOrigem.replace(' ', '+'));
      url.append("&destination=");
      url.append(editDestino.replace(' ', '+'));

      final InputStream stream = new URL(url.toString()).openStream();

      final DocumentBuilderFactory documentBuilderFactory = 
      DocumentBuilderFactory.newInstance();
      documentBuilderFactory.setIgnoringComments(true);

      final DocumentBuilder documentBuilder = documentBuilderFactory.newDocumentBuilder();

      final Document document = documentBuilder.parse(stream);
      document.getDocumentElement().normalize();

      final String status = document.getElementsByTagName("status").item(0).getTextContent();
      if(!"OK".equals(status)) {
        return false;
      }

      final Element elementLeg = (Element) document.getElementsByTagName("leg").item(0);
      final NodeList nodeListStep = elementLeg.getElementsByTagName("step");
      final int length = nodeListStep.getLength();

      for(int i=0; i<length; i++) {        
        final Node nodeStep = nodeListStep.item(i);

        if(nodeStep.getNodeType() == Node.ELEMENT_NODE) {
          final Element elementStep = (Element) nodeStep;
          decodePolylines(elementStep.getElementsByTagName("points")
          .item(0).getTextContent());
          }
    }

      return true;          
    }
    catch(final Exception e) {
      return false;
    }
  }
 
  private void decodePolylines(final String encodedPoints) {
    int index = 0;
    int lat = 0, lng = 0;

    while (index < encodedPoints.length()) {
      int b, shift = 0, result = 0;

      do {
        b = encodedPoints.charAt(index++) - 63;
        result |= (b & 0x1f) << shift;
        shift += 5;
      } while (b >= 0x20);

      int dlat = ((result & 1) != 0 ? ~(result >> 1) : (result >> 1));
      lat += dlat;
      shift = 0;
      result = 0;

      do {
        b = encodedPoints.charAt(index++) - 63;
        result |= (b & 0x1f) << shift;
        shift += 5;
      } while (b >= 0x20);

      int dlng = ((result & 1) != 0 ? ~(result >> 1) : (result >> 1));
      lng += dlng;

      lstLatLng.add(new LatLng((double)lat/1E5, (double)lng/1E5));
    }
  }
 
  /**
  * {@inheritDoc}
  */
  @Override
  protected void onPostExecute(final Boolean result) { 
    if(!result) {
      Toast.makeText(context, TOAST_ERR_MAJ, Toast.LENGTH_SHORT).show();
    }
    else {
      final PolylineOptions polylines = new PolylineOptions();
      polylines.color(Color.BLUE);

      for(final LatLng latLng : lstLatLng) {
              polylines.add(latLng);
      }

      final MarkerOptions markerA = new MarkerOptions();
      markerA.position(lstLatLng.get(0));
      markerA.icon(BitmapDescriptorFactory.defaultMarker(BitmapDescriptorFactory.HUE_GREEN));

      final MarkerOptions markerB = new MarkerOptions();
      markerB.position(lstLatLng.get(lstLatLng.size()-1));
      markerB.icon(BitmapDescriptorFactory.defaultMarker(BitmapDescriptorFactory.HUE_RED));

      gMap.moveCamera(CameraUpdateFactory.newLatLngZoom(lstLatLng.get(0), 10));
      gMap.addMarker(markerA);
      gMap.addPolyline(polylines);
      gMap.addMarker(markerB); 
    }
  }
}

Listagem 5. Classe AsyncTask

Como pode ser observado, uma AsyncTask deve implementar os seguintes m�todos:

onPreExecute(): Esse m�todo � invocado pela thread principal antes da execu��o da AsyncTask e deve ser usado para executar atividades relevantes para a execu��o da task, como checagem de par�metros nulos e abertura de conex�es com uma base de dados;
doInBackground(): Esse m�todo � executado imediatamente ap�s o t�rmino da execu��o do m�todo onPreExecute() e conter� o processamento que desejamos executar em segundo plano;
onPostExecute(): M�todo � executado ap�s o t�rmino do processamento. O retorno do m�todo doInBackground() � passado para esse m�todo como par�metro.

Para uma AsyncTask funcionar adequadamente, o desenvolvedor dever� atentar para os seguintes pontos:

A AsyncTask deve ser carregada na thread principal;
O m�todo execute() deve ser chamado na thread principal;
Os m�todos onPreExecute(), doInBackground() e onPostExecute() n�o devem ser chamados manualmente.

Nota: De acordo com a documenta��o da API, as AsyncTasks devem ser utilizadas preferencialmente para processamentos de curta dura��o(segundos). Opera��es que necessitem de um processamento mais demorado devem fazer uso das APIs disponibilizadas no pacote java.util.concurrent, como Executor, ThreadPoolExecutor e FutureTask.

Executando a requisi��o para a Google Directions API

A documenta��o da Google Directions API especifica que uma requisi��o dever� ter o seguinte formato:

http://maps.googleapis.com/maps/api/directions/output?parameters

O par�metro output especifica o tipo de retorno da requisi��o, que poder� ser XML ou JSON. No nosso exemplo, al�m desse par�metro, especificaremos os par�metros origin e destination, para designar os pontos de origem e destino, respectivamente. Tamb�m usaremos o par�metro sensor, para especificar se a rota vem de um dispositivo de localiza��o, e o par�metro language como pt-BR, para que o aplicativo entenda buscas textuais na l�ngua portuguesa (ruas, avenidas, etc.).

Utilizaremos a API padr�o do Java para realizar o parsing do XML retornado pela aplica��o e delegaremos o processamento para o m�todo decodePolilynes(), que � um m�todo utilit�rio encontrado na Internet (semelhante ao que ocorre com m�todos de valida��o de CPF, por exemplo). Ele ser� respons�vel por transformar a rota codificada em um array de objetos do tipo LatLng, que � a classe do Google respons�vel por encapsular as informa��es de latitude e longitude.

A classe PolylineOptions agrupa um conjunto de objetos do tipo Polyline, que representam os trechos da rota a ser percorrida entre um ponto e outro. A classe MarkerOptions encapsula um objeto do tipo LatLng, que serve para designar as coordenadas de latitude e longitude de uma determinada localidade. Nela tamb�m encontramos o m�todo setIcon(), respons�vel por adicionar o �cone representativo de uma localidade, no nosso caso ilustrado pelos cl�ssicos �bal�ezinhos� verde e vermelho.

A classe CameraUpdateFactory, como pode ser deduzido pelo seu nome, � uma classe que atua como �f�brica� para a cria��o de objetos do tipo CameraUpdate, que s�o respons�veis por mudar o posicionamento do mapa. O m�todo est�tico newLatLngZoom() retorna um objeto CameraUpdate que move o centro da tela para uma latitude e longitude especificadas por um objeto do tipo LatLng e modifica o zoom especificado.

Para mudar o n�vel de zoom do mapa que est� sendo apresentado, a classe CameraUpdate disponibiliza outros m�todos utilit�rios como:

zoomIn(): este m�todo incrementa o zoom em 1.0;
zoomOut(): este m�todo decrementa o zoom em 1.0;
zoomTo(float zoom): incrementa o zoom com o valor especificado.

Finalmente, utilizamos o m�todo addPolyline() da classe GoogleMap para renderizar no mapa o caminho a ser percorrido entre o ponto de origem e destino.

Este artigo teve como objetivo introduzir o leitor no mundo dos aplicativos georreferenciados, utilizando a famosa API do Google Maps para demonstrar um exemplo simples de c�lculo e exibi��o de rotas. Esperamos com esse artigo ter despertado no leitor a curiosidade e o interesse em aprofundar o conhecimento nessa fant�stica �rea da computa��o m�vel.

Nota:

Confira tamb�m

Curso de Android

Curso

Curso de Android SDK

Curso

Android InputMask e Saripaar 2

Curso

Tecnologias:

Confira outros conte�dos:

Programador Mobile

Desenvolvimento de aplicativos para...

Conceitos b�sicos para programar para...

Assista grátis a nossa aula inaugural

Perguntas frequentes

Quem somos?

Por que a programação se tornou a profissão mais promissora da atualidade?

Como faço para começar a estudar?

Em quanto tempo de estudo vou me tornar um programador?

Sim, você pode se tornar um programador e não precisa ter diploma de curso superior!

O que eu irei aprender estudando pela DevMedia?

Principais diferenciais da DevMedia

Qual o investimento financeiro que preciso fazer para me tornar um programador?

Como funciona a forma de pagamento da DevMedia?

Por Devmedia Em 2014

Nossos casos de sucesso

Leonardo Carlos

Eu sabia pouqu�ssimas coisas de programa��o antes de come�ar a estudar com voc�s, fui me especializando em v�rias �reas e ferramentas que tinham na plataforma, e com essa bagagem consegui um est�gio logo no in�cio do meu primeiro per�odo na faculdade.

Lucas Rodrigues

Estudo aqui na Dev desde o meio do ano passado! Nesse per�odo a Dev me ajudou a crescer muito aqui no trampo.
Fui o primeiro desenvolvedor contratado pela minha empresa. Hoje eu lidero um time de desenvolvimento!
Minha meta � continuar estudando e praticando para ser um Full-Stack Dev!

Her�clito J�nior

Economizei 3 meses para assinar a plataforma e sendo sincero valeu muito a pena, pois a plataforma � bem intuitiva e muuuuito did�tica a metodologia de ensino. Sinto que estou EVOLUINDO a cada dia. Muito obrigado!

Julio Cablen

Nossa! Plataforma maravilhosa. To amando o curso de desenvolvimento front-end, tinha coisas que eu ainda n�o tinha visto. A did�tica � do jeito que qualquer pessoa consegue aprender. S�rio, to apaixonado, adorando demais.

Joelberth Sena

Adquiri o curso de voc�s e logo percebi que s�o os melhores do Brasil. � um passo a passo incr�vel. S� n�o aprende quem n�o quer. Foi o melhor investimento da minha vida!

Felipe Nunes

Foi um dos melhores investimentos que j� fiz na vida e tenho aprendido bastante com a plataforma. Voc�s est�o fazendo parte da minha jornada nesse mundo da programa��o, irei assinar meu contrato como programador gra�as a plataforma.

Wanderson Oliveira

Comprei a assinatura tem uma semana, aprendi mais do que 4 meses estudando outros cursos. Exerc�cios pr�ticos que n�o tem como n�o aprender, est�o de parab�ns!

Jos� Lucas

Obrigado DevMedia, nunca presenciei uma plataforma de ensino t�o presente na vida acad�mica de seus alunos, parab�ns!

Eduardo Dorneles

Aprendi React na plataforma da DevMedia h� cerca de 1 ano e meio... Hoje estou h� 1 ano empregado trabalhando 100% com React!

Adauto Junior

J� fiz alguns cursos na �rea e nenhum � t�o bom quanto o de voc�s. Estou aprendendo muito, muito obrigado por existirem. Est�o de parab�ns... Espero um dia conseguir um emprego na �rea.

Ver todos os casos de sucesso

Tra�ando rotas no Android com a Google Directions

Descubra nesse artigo como � simples fazer uso de geolocaliza��o em seus aplicativos m�veis.

Obtendo a localiza��o de um objeto

GPS

Triangula��o de Antenas

Exemplo de aplica��es de geolocaliza��o

Find Friend

Waze

Vis�o geral da Google Directions AP

Limites de uso

Criando uma aplica��o usando a Google Directions API

Criando a activity principal

Recuperando par�metros e mostrando o mapa

Utilizando Fragments e a classe MapFragment

Utilizando AsyncTasks

Executando a requisi��o para a Google Directions API

Confira tamb�m

Curso de Android

Curso de Android SDK

Android InputMask e Saripaar 2

Confira outros conte�dos:

Programador Mobile

Desenvolvimento de aplicativos para...

Conceitos b�sicos para programar para...

Perguntas frequentes

Nossos casos de sucesso