Harita oluşturun

Platform seçin: Android iOS

Tüketici uygulamanızda bir yolculuğu takip etmek için önce bir harita tanımlamanız ve gerekirse vektör haritalar için destek eklemeniz gerekir.

Uygulamanızda harita oluşturmak için aşağıdaki adımları uygulayın:

  1. Bir geziyi takip etmek için harita parçası tanımlayın.
  2. Haritalar temel katmanı ve görünüm denetleyicisi için destek ekleyin.
  3. Gerekirse vektör haritaları görüntülemek için Android vektör grafikleri desteği ekleyin.

Bir harita tanımladıktan sonra, görsel deneyimi özelleştirmek için istediğiniz ek görünümleri ve kamera kontrollerini ekleyebilirsiniz. Daha fazla bilgi için Harita stili başlıklı makaleyi inceleyin.

1. adım: Bir geziyi takip etmek için harita parçası tanımlayın

Tüketici uygulamanızda isteğe bağlı bir yolculuğu paylaştığınız haritayı oluşturmak için bir harita parçası veya görünümü ekleyerek haritayı tanımlarsınız. Haritanızı tanımlamak için aşağıdaki yöntemlerden birini kullanın:

  • ConsumerMapFragment: Haritanızı Fragment ile tanımlamak için kullanılır.

  • ConsumerMapView: View içeren bir harita tanımlamak için kullanılır.

Her iki yöntemde de özellikler aynıdır. Bu nedenle, uygulamanız için daha iyi olan yöntemi seçin.

Her iki yöntem de aşağıdaki bölümde daha ayrıntılı olarak açıklanmaktadır.

Harita parçası veya görünümü ekleme

Android parçası veya görünüm kullanarak gezi ilerleme durumunu gösteren bir harita oluşturmak için aşağıdaki adımları uygulayın ve kod örneklerine bakın.

  1. /res/layout konumundaki uygulama düzeni XML dosyanızda bir parça veya görünüm tanımlayın. Seyahat haritasını ConsumerMapFragment kullanarak bir parça veya ConsumerMapView kullanarak bir görünüm olarak tanımlayın.

    Daha sonra bu parça veya görünüm, uygulamanızın erişip değiştirebileceği gezi haritasına erişim sağlar. Harita ayrıca ConsumerController için bir tutma yeri sağlar. Bu tutma yeri, uygulamanızın tüketici deneyimini kontrol etmesine ve özelleştirmesine olanak tanır.

  2. onCreate() yönteminizden getConsumerGoogleMapAsync(callback) yöntemini çağırın. Bu yöntem, geri çağırmada ConsumerGoogleMap değerini eşzamansız olarak döndürür.

  3. Seyahat ilerleme durumunu göstermek ve gerektiğinde güncellemek için ConsumerGoogleMap simgesini kullanın.

ConsumerMapFragment ekleme örneği

  1. Parçayı, aşağıdaki kod örneğinde gösterildiği gibi uygulama düzeni XML dosyanızda tanımlayın.

    <fragment
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:name="com.google.android.libraries.mapsplatform.transportation.consumer.view.ConsumerMapFragment"
    android:id="@+id/consumer_map_fragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

  2. onCreate() yöntemini kullanarak getConsumerGoogleMapAsync() adlı kişiyi arayın.

Java

 public class SampleAppActivity extends AppCompatActivity {

   @Override
   protected void onCreate(Bundle savedInstanceState) {

     // Find the ConsumerMapFragment.
     ConsumerMapFragment consumerMapFragment =
         (ConsumerMapFragment) fragmentManager.findFragmentById(R.id.consumer_map_fragment);

     // Initiate the callback that returns the map.
     if (consumerMapFragment != null) {
       consumerMapFragment.getConsumerGoogleMapAsync(
           new ConsumerMapReadyCallback() {
             // The map returned in the callback is used to access the ConsumerController.
             @Override
             public void onConsumerMapReady(@NonNull ConsumerGoogleMap consumerGoogleMap) {
               ConsumerController consumerController = consumerGoogleMap.getConsumerController();
             }
           });
     }
   }

 }

Kotlin

 class SampleAppActivity : AppCompatActivity() {
   override fun onCreate(savedInstanceState: Bundle?) {
     // Find the ConsumerMapFragment.
     val consumerMapFragment =
       fragmentManager.findFragmentById(R.id.consumer_map_fragment) as ConsumerMapFragment

     consumerMapFragment.getConsumerGoogleMapAsync(
       object : ConsumerMapReadyCallback() {
         override fun onConsumerMapReady(consumerGoogleMap: ConsumerGoogleMap) {
           val consumerController = consumerGoogleMap.getConsumerController()!!
         }
       }
     )
   }
 }

ConsumerMapView ekleme örneği

  1. Görünümü, XML dosyanızda tanımlandığı şekilde bir parçada veya etkinlikte kullanın.

     <com.google.android.libraries.mapsplatform.transportation.consumer.view.ConsumerMapView
     xmlns:android="http://schemas.android.com/apk/res/android"
     android:id="@+id/consumer_map_view"
     android:layout_width="match_parent"
     android:layout_height="match_parent" />

  2. onCreate() adlı kişiden getConsumerGoogleMapAsync() adlı kişiyi arama Geri çağırma parametresine ek olarak aşağıdaki ayrıntıları da ekleyin:

    • Etkinliği veya parçayı içeren. Etkinlik veya parça temel sınıfı, yaşam döngüsüne erişim sağladığından FragmentActivity ya da destek Fragment olmalıdır (sırasıyla).

    • GoogleMapOptions (boş olabilir), MapView için yapılandırma özelliklerini içerir.

Java

public class SampleAppActivity extends AppCompatActivity {

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    ConsumerMapView mapView = findViewById(R.id.consumer_map_view);

    if (mapView != null) {
      mapView.getConsumerGoogleMapAsync(
          new ConsumerMapReadyCallback() {
            // The map returned in the callback is used to access the ConsumerController.
            @Override
            public void onConsumerMapReady(@NonNull ConsumerGoogleMap consumerGoogleMap) {
              ConsumerController consumerController = consumerGoogleMap.getConsumerController();
            }
          }, this, null);
    }
  }

}

Kotlin

class SampleAppActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    val mapView = findViewById(R.id.consumer_map_view) as ConsumerMapView

    mapView.getConsumerGoogleMapAsync(
      object : ConsumerMapReadyCallback() {
        // The map returned in the callback is used to access the ConsumerController.
        override fun onConsumerMapReady(consumerGoogleMap: ConsumerGoogleMap) {
          val consumerController = consumerGoogleMap.getConsumerController()!!
        }
      },
      /* fragmentActivity= */ this,
      /* googleMapOptions= */ null,
    )
  }
}

Bir parçadaki MapView, bir etkinlikteki MapView için önceki örnekle aynıdır. Ancak parçadaki, onCreateView() yönteminde MapView içeren düzeni genişletir.

Java

public class MapViewInFragment extends Fragment {

  @Override
  public View onCreateView(
      @NonNull LayoutInflater layoutInflater,
      @Nullable ViewGroup viewGroup,
      @Nullable Bundle bundle) {
    return layoutInflater.inflate(R.layout.consumer_map_view, viewGroup, false);
  }

}

Kotlin

class MapViewInFragment : Fragment() {
  override fun onCreateView(
    layoutInflater: LayoutInflater,
    container: ViewGroup?,
    savedInstanceState: Bundle?,
  ): View {
    return layoutInflater.inflate(R.layout.consumer_map_view, viewGroup, false)
  }
}

2. adım: Haritalar temel katmanı ve görünüm denetleyicisi için destek ekleyin

Uygulamanızda gezi seyrini paylaşmak için uygulamanıza aşağıdaki sınıfları ekleyin: ConsumerGoogleMap ve ConsumerController.

  • ConsumerGoogleMap değerini ConsumerMapFragment veya ConsumerMapView'dan alın. Her ikisi de ConsumerGoogleMap değerini ConsumerMapReadyCallback içinde eşzamansız olarak döndürür.

    ConsumerGoogleMap, GoogleMap sınıfı için bir sarmalayıcı sınıftır. Uygulamanızın haritayla etkileşime geçebilmesi için GoogleMap'ya eşdeğer bir API kullanır. Bu sayede uygulamanız, aynı temel Google Haritası ile sorunsuz şekilde etkileşim kurabilir. Örneğin, GoogleMap yalnızca tek bir geri çağırma kaydına izin verirken ConsumerGoogleMap, çift kayıtlı geri çağırmaları destekler. Bu geri çağırmalar, uygulamanızın sırayla çağrılan geri çağırmaları kaydetmesine olanak tanır.

  • getConsumerController() şehrinde ConsumerGoogleMap istasyonundan ConsumerController hattını kullanın.

    ConsumerController; gezileri izleme, gezi durumunu kontrol etme ve konum ayarlama gibi gezi paylaşımı özelliklerine erişim sağlar.

Java ve Kotlin'de uygulamanıza ConsumerGoogleMap ve ConsumerController ekleme hakkında bilgi edinmek için aşağıdaki örneklere bakın.

Java

private ConsumerGoogleMap consumerGoogleMap;
private ConsumerController consumerController;
private ConsumerMapView consumerMapView;

consumerMapView.getConsumerGoogleMapAsync(
    new ConsumerMapReadyCallback() {
      @Override
      public void onConsumerMapReady(@NonNull ConsumerGoogleMap consumerMap) {
        consumerGoogleMap = consumerMap;
        consumerController = consumerMap.getConsumerController();
      }
    },
    this, null);

Kotlin

var consumerGoogleMap: ConsumerGoogleMap
var consumerController: ConsumerController
val consumerMapView = findViewById(R.id.consumer_map_view) as ConsumerMapView

consumerMapView.getConsumerGoogleMapAsync(
  object : ConsumerMapReadyCallback() {
    override fun onConsumerMapReady(consumerMap: ConsumerGoogleMap) {
      consumerGoogleMap = consumerMap
      consumerController = consumerMap.getConsumerController()
    },
    /* fragmentActivity= */ this,
    /* googleMapOptions= */ null,
  }
)

3. adım: Android vektör grafikleri için destek ekleyin

Uygulama tasarımınızda vektör grafikler için destek gerekiyorsa aşağıdaki adımları uygulayarak Android cihazlar ve vektör çizilebilir öğeler için destek ekleyin:

  1. Aşağıdaki kodu etkinliğinize ekleyin. Bu kod, Consumer SDK'da vektör çizilebilir öğelerin kullanılmasını sağlamak için AppCompatActivity uzantısını kullanır.

Java

// ...
import android.support.v7.app.AppCompatActivity;

// ...

public class ConsumerTestActivity extends AppCompatActivity {
  // ...
}

Kotlin

// ...
import android.support.v7.app.AppCompatActivity

// ...

class ConsumerTestActivity : AppCompatActivity() {
  // ...
}

Sonraki Adımlar

Android'de bir geziyi takip etme

Harita stilini değiştirme