Here-api'yi kullanmaya başlama

Yeni Bir Android Studio Projesi Oluşturun

  1. Yeni Proje Oluştur iletişim kutusunu açmak için Android Studio’ya Hoş Geldiniz iletişim kutusundan Yeni Proje… öğesini seçin.

  2. Yeni Android Uygulaması iletişim kutusunda, Uygulama adı altında uygun bir uygulama adı belirtin. Bu öğreticinin geri kalanında uygulama adı olarak BasicMapSolution kullanılır.

  3. Şirket Etki Alanı altında uygun bir etki alanı belirtin.

  4. Düzenle bağlantısını tıklayarak paket adını düzenleyin. Bu öğreticinin geri kalanında paket adı olarak com.here.android.tutorial kullanılır.

    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. Proje Konumu altında, dosya sisteminde uygun bir proje konumu belirtin.

  6. İleri’ye tıklayın.

  7. Uygulamanız tarafından desteklenen form faktörlerini seçin. Bu eğitimin amacı için Telefon ve Tablet’i kontrol edin.

  8. Minimum SDK altında, desteklemek istediğiniz Android SDK’nın en düşük sürümünü seçin. Bu örnek uygulama için Android 4.0.3 “Ice Cream Sandwich” kullanın.

  9. İleri’ye tıklayın.

  10. Bir Lisans Sözleşmesini kabul etmeniz istenebilir. SDK bileşenlerini yüklemek için Kabul Et’e ve ardından İleri’ye tıklayın. Kurulum tamamlandıktan sonra tekrar İleri’ye tıklayın.

  11. “Mobil’e bir etkinlik ekle” iletişim kutusunda, Boş Etkinlik’i seçin ve İleri’ye tıklayın.

  12. “Customize Activity” iletişim kutusunda, Activity Name kısmında uygun bir aktivite ismi belirtin. Bu öğretici, BasicMapActivity adını kullanır.

  13. Düzen Adı altında uygun bir düzen adı belirtin. (Bu öğretici, Activity_main kullanır.)

  14. Bitir’e tıklayın.

Harita Parçasını Başlatma

Uygulamanın temel düzenini tanımladığınızda ve gerekli izinleri aldığınızda, son adım MapFragment sınıfının örneğini başlatmak, böylece bir Map oluşturmak ve aktivite_main.xml dosyasında bildirilen MapFragment ile ilişkilendirmektir.

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");
        }
      }
    });
  }
}

HERE SDK Kimlik Bilgilerini Alın

Tipik olarak, yeni bir HERE SDK uygulaması geliştirmeden önce, uygulamanızı http://developer.here.com adresinde kaydettirerek bir dizi kimlik bilgisi edinmeniz gerekir. Her uygulama benzersiz bir kimlik bilgileri kümesi gerektirir. Uygulamanızı kaydettiğinizde, kayıtlı paket tanımlayıcısı projenizdeki paket adıyla eşleşmelidir.

Her uygulama, ticari veya değerlendirme, şirketi tanımlamak için bir uygulama ve uygulama kodu çifti gerektirir. Ek olarak, HERE Premium SDK için, gelişmiş adım adım ve çevrimdışı özelliklere erişim sağlamak için bir “lisans anahtarı” kullanılır.

Premium SDK için lütfen bakın: https://developer.here.com/mobile-sdks/documentation/android-hybrid-plus/topics/credentials.html

Başlangıç ​​SDK’sı için lütfen bakın: https://developer.here.com/mobile-sdks/documentation/android/topics/credentials.html

Resmi Github örnekleri

HERE Android Premium SDK örnekleri Artık Github’da mevcut! https://github.com/heremaps/here-android-sdk-examples

HERE iOS Premium SDK örnekleri Artık Github’da mevcut! https://github.com/heremaps/here-ios-sdk-examples

Lütfen nasıl başlayacağınız konusunda README.md’ye bakın. Örneklerin çalışması için bir izin anahtarı gerektirdiğini unutmayın.