Primeros pasos con here-api

Crear un nuevo proyecto de Android Studio

  1. En el cuadro de diálogo Bienvenido a Android Studio, seleccione Nuevo proyecto… para abrir el cuadro de diálogo Crear nuevo proyecto.

  2. En el cuadro de diálogo Nueva aplicación de Android, en Nombre de la aplicación, especifique un nombre de aplicación adecuado. El resto de este tutorial usa BasicMapSolution como el nombre de la aplicación.

  3. En Dominio de la empresa, especifique un dominio adecuado.

  4. Edite el nombre del paquete haciendo clic en el enlace Editar. El resto de este tutorial usa com.here.android.tutorial como nombre del paquete.

    Important: You must use the same package name as you have registered on developer.here.com. Failure to do so leads to a blank map to appear in your application.

    You can also edit this package name later in your AndroidManifest.xml:

  5. En Ubicación del proyecto, especifique una ubicación de proyecto adecuada en el sistema de archivos.

  6. Haga clic en Siguiente.

  7. Seleccione los factores de forma admitidos por su aplicación. A los efectos de este tutorial, marque Teléfono y tableta.

  8. En SDK mínimo, seleccione la versión más baja del SDK de Android que desea admitir. Para esta aplicación de muestra, utilice Android 4.0.3 “Ice Cream Sandwich”.

  9. Haga clic en Siguiente.

  10. Es posible que se le solicite que acepte un Acuerdo de licencia. Haga clic en Aceptar y luego en Siguiente para instalar los componentes del SDK. Una vez finalizada la instalación, haga clic en Siguiente de nuevo.

  11. En el cuadro de diálogo “Agregar una actividad a Mobile”, seleccione Actividad vacía y haga clic en Siguiente.

  12. En el cuadro de diálogo “Personalizar actividad”, especifique un nombre de actividad apropiado en Nombre de actividad. Este tutorial usa el nombre BasicMapActivity.

  13. En Nombre del diseño, especifique un nombre de diseño adecuado. (Este tutorial usa activity_main).

  14. Haga clic en Finalizar.

Inicializando el Fragmento de Mapa

Cuando haya definido el diseño básico de la aplicación y haya adquirido los permisos necesarios, el paso final es inicializar la instancia de la clase MapFragment, creando así y asociando un Mapa con el MapFragment declarado en el archivo activity_main.xml.

public class BasicMapActivity extends Activity {

  // map embedded in the map fragment
  private Map map = null;

  // map fragment embedded in this activity
  private MapFragment mapFragment = null;

  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    initialize();
  }

  private void initialize() {
    setContentView(R.layout.activity_main);

    mapFragment = (MapFragment)getFragmentManager().findFragmentById(R.id.mapfragment);
    mapFragment.init(new OnEngineInitListener() {
      @Override
      public void onEngineInitializationCompleted(OnEngineInitListener.Error error)
      {
        if (error == OnEngineInitListener.Error.NONE) {
          map = mapFragment.getMap();  
          map.setCenter(new GeoCoordinate(49.196261, -123.004773, 0.0),
                  Map.Animation.NONE);  
          map.setZoomLevel(
            (map.getMaxZoomLevel() + map.getMinZoomLevel()) / 2);
        } else {
          System.out.println("ERROR: Cannot initialize Map Fragment");
        }
      }
    });
  }
}

Adquirir credenciales de HERE SDK

Por lo general, antes de desarrollar una nueva aplicación HERE SDK, debe adquirir un conjunto de credenciales registrando su aplicación en http://developer.here.com. Cada aplicación requiere un conjunto único de credenciales. Cuando registra su aplicación, el identificador del paquete registrado debe coincidir con el nombre del paquete en su proyecto.

Cada aplicación, comercial o evaluación requiere un par de código de appid y app para identificar a la empresa. Además, para HERE Premium SDK se utiliza una “clave de licencia” para brindar acceso a funciones avanzadas paso a paso y fuera de línea.

Para SDK premium, consulte: https://developer.here.com/mobile-sdks/documentation/android-hybrid-plus/topics/credentials.html

Para el SDK de inicio, consulte: https://developer.here.com/mobile-sdks/documentation/android/topics/credentials.html

Ejemplos oficiales de Github

AQUÍ muestras de Android Premium SDK ¡Ya disponible en Github! https://github.com/heremaps/here-android-sdk-examples

AQUÍ ejemplos de SDK premium de iOS ¡Ya disponible en Github! https://github.com/heremaps/here-ios-sdk-examples

Consulte el archivo README.md para saber cómo empezar. Tenga en cuenta que las muestras requieren una clave de permiso para funcionar.