Maps SDK — Setup

Esta seção te guiará pelo processo de instalação e inicialização do Zapt Maps SDK. No final, você poderá verificar se o SDK está funcionando corretamente e pronto para ser usado.

Android

Esta seção te guiará pelo processo de instalação e inicialização do Zapt Maps SDK para Android. No final, você poderá verificar se o SDK está funcionando corretamente e pronto para ser usado.

Requisitos Mínimos

Requisito	Versão
Android SDK versão mínima (minSdkVersion)	Android versão 4.0.3 ou superior (API 15+)

Requisição de Permissão

No arquivo AndroidManifest.xml adicionar a permissão para acessar a internet e áudio.

XML

<manifest xmlns:android="http://schemas.android.com/apk/res/android">
  <uses-permission android:name="android.permission.INTERNET"/>
  <uses-permission android:name="android.permission.RECORD_AUDIO"/>
  <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS"/>
  ...
</manifest>

Para habilitar a busca por voz, utilize o parâmetro correspondente enableMicSearch. Clique aqui para visualizar a seção de parâmetros de URL e obter mais informações.

Configurando o ZaptWebView

Aviso

Os links de mapas podem ser utilizados em um WebView convencional do Android. Porém, devido à falta de suporte à síntese de voz, algumas funcionalidades como rota guiada por voz podem não funcionar corretamente. Por isso, recomendamos a utilização do ZaptWebView, que traz correções para esta limitação.

Para configurar o ZaptWebView:

1) Declare a dependência do ZaptSDK, de acordo com essas instruções.

2) Declare-o no arquivo XML de layout de sua Activity.

XML

<?xml version="1.0" encoding="utf-8"?>
<android.support.constraint.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
  xmlns:app="http://schemas.android.com/apk/res-auto"
  xmlns:tools="http://schemas.android.com/tools"
  android:layout_width="match_parent"
  android:layout_height="match_parent"
  tools:context=".WebViewActivity">

  <tech.zapt.sdk.webapp.ZaptWebView
    android:id="@+id/webView"
    android:layout_width="0dp"
    android:layout_height="0dp"
    app:layout_constraintBottom_toBottomOf="parent"
    app:layout_constraintEnd_toEndOf="parent"
    app:layout_constraintStart_toStartOf="parent"
    app:layout_constraintTop_toTopOf="parent" />

</android.support.constraint.ConstraintLayout>

3) Na Activity, inicializar ZaptWebView com a URL personalizada com base nas opções de layout.

Java

private WebView webView;

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_web_view);

    webView = (WebView) findViewById(R.id.webView);

    String url = "URL_PERSONALIZADA"; // Sua URL personalizada vai aqui
    startWebView(url);
}

private void startWebView(String url) {
    webView.loadUrl(url);
}

Se preferir utilizar o WebView convencional do Android, mesmo entendendo que as orientações por voz não estarão disponíveis, inicialize-o dessa maneira:

XML

<?xml version="1.0" encoding="utf-8"?>
<android.support.constraint.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
  xmlns:app="http://schemas.android.com/apk/res-auto"
  xmlns:tools="http://schemas.android.com/tools"
  android:layout_width="match_parent"
  android:layout_height="match_parent"
  tools:context=".WebViewActivity">

  <WebView
    android:id="@+id/webView"
    android:layout_width="0dp"
    android:layout_height="0dp"
    app:layout_constraintBottom_toBottomOf="parent"
    app:layout_constraintEnd_toEndOf="parent"
    app:layout_constraintStart_toStartOf="parent"
    app:layout_constraintTop_toTopOf="parent" />

</android.support.constraint.ConstraintLayout>

Java

private void startWebView(String url) {
    webView.getSettings().setJavaScriptEnabled(true);
    webView.getSettings().setDomStorageEnabled(true);
    webView.getSettings().setAppCacheEnabled(true);
    webView.getSettings().setJavaScriptCanOpenWindowsAutomatically(true);
    webView.getSettings().setGeolocationEnabled(true);

    webView.loadUrl(url);
}

Se você ainda não recebeu a URL personalizada do seu local, por favor entre em contato através do email contato@zapt.tech.

Exemplo

O código de exemplo de uma aplicação Android está disponível no GitHub.

iOS

Para integrar o Zapt Maps SDK no iOS utilize WebView.

Veja aqui a implementação de referência de WebView no iOS.

E, aqui um tutorial de implementação de WebView no iOS.

Requisição de Permissão

O SDK requer que determinados recursos sejam ativados em seu aplicativo para usar os serviços de busca por voz. Para isso:

Edite o arquivo Info.plist, adicione as chaves NSMicrophoneUsageDescription e NSSpeechRecognitionUsageDescription. O valor dessas chaves é a mensagem que será exibida na tela do usuário quando solicitado a permitir o uso de busca por voz. Para informações adicionais, visite a página oficial da documentação da Apple acessando aqui. Para habilitar a busca por voz, utilize o parâmetro correspondente enableMicSearch. Clique aqui para visualizar a seção de parâmetros de URL e obter mais informações.

Web

Esta seção te guiará pelo processo de instalação e inicialização do Zapt Maps SDK para navegadores Web. No final, você poderá verificar se o SDK está funcionando corretamente e pronto para ser usado.

Requisitos Mínimos

Requisito	Versão
HTML	4.01 ou superior

Modos de exibição

Criar um iframe em sua página passando como source a URL personalizada.

Escolher o width e height para definir o modo de exibição.

HTML

<iframe src="URL_PERSONALIZADA" width="1080px" height="607.5px"></iframe>

Se você ainda não recebeu a URL personalizada do seu local, por favor entre em contato através do email contato@zapt.tech.

Tamanho do Iframe	Modo de exibição
width < 600px	Celular
600px ≤ width ≤ 1023px	Tablet
width > 1023px	TV

Exemplo

O código de exemplo de uma aplicação Web está disponível no GitHub.