Khởi chạy SDK người tiêu dùng

Trước khi bắt đầu các quy trình này, hãy đảm bảo bạn đã bật các dịch vụ và SDK tiêu dùng thích hợp như mô tả trong các phần trước.

Để khởi chạy SDK dành cho người dùng, hãy làm theo các bước sau:

1. Lấy thực thể ConsumerAPI
2. Khởi chạy SDK Bản đồ để yêu cầu trình kết xuất ưu tiên

Lấy thực thể ConsumerApi

Để sử dụng SDK dành cho người dùng, ứng dụng của bạn cần khởi chạy ConsumerApi singleton một cách không đồng bộ. Phương thức khởi chạy sẽ lấy lớp AuthTokenFactory để tạo mã thông báo JWT mới cho người dùng khi cần.

providerId là Mã dự án của Dự án Google Cloud. Để biết thêm thông tin về cách tạo dự án Fleet Engine, hãy xem phần Tạo dự án Fleet Engine trong hướng dẫn về Fleet Engine.

Ứng dụng của bạn phải triển khai AuthTokenFactory như mô tả trong phần Xác thực SDK người tiêu dùng.

Task<ConsumerApi> consumerApiTask = ConsumerApi.initialize(
    this, "myProviderId", authTokenFactory);

consumerApiTask.addOnSuccessListener(
  consumerApi -> this.consumerApi = consumerApi);

val consumerApiTask =
  ConsumerApi.initialize(this, "myProviderId", authTokenFactory)

consumerApiTask?.addOnSuccessListener { consumerApi: ConsumerApi ->
  this@YourActivity.consumerApi = consumerApi
}

SDK Maps và trình kết xuất bản đồ

SDK người tiêu dùng phiên bản 2.0.0 trở lên hỗ trợ SDK Maps dành cho Android phiên bản 18.1.0 trở lên. Bảng sau đây tóm tắt trình kết xuất mặc định theo phiên bản SDK Maps và khả năng hỗ trợ của cả hai trình kết xuất. Nếu có thể, hãy sử dụng trình kết xuất đồ hoạ mới nhất. Nếu bạn phải sử dụng trình kết xuất cũ, hãy chỉ định rõ trình kết xuất đó bằng cách sử dụng MapsInitializer.initialize().

* Khi Trình kết xuất Maps mới ra mắt, trình kết xuất mới nhất sẽ là trình kết xuất mặc định.

Nếu bạn phải sử dụng trình kết xuất ưu tiên, hãy chạy tất cả các thao tác kết xuất giao diện người dùng sau khi OnMapsSdkInitializedCallback trả về kết quả. Các thao tác kết xuất giao diện người dùng bao gồm các thao tác sau:

• Tăng cường khung hiển thị chứa GoogleMapView hoặc ConsumerMapView.

• Đặt điểm đánh dấu trên ConsumerMapView.

Nếu bạn không chạy các thao tác này sau khi nhận được kết quả OnMapsSdkInitializedCallback, thì SDK Maps sẽ không phân bổ trình kết xuất ưu tiên của bạn và thay vào đó, trình kết xuất bản đồ sẽ kết xuất chế độ xem bản đồ.

Khởi chạy SDK Bản đồ trước khi khởi chạy SDK Người dùng

1. Trong lớp Application hoặc lớp khởi động Activity, hãy gọi MapsInitializer.initialize()

2. Chờ kết quả yêu cầu trình kết xuất trước khi khởi chạy SDK người tiêu dùng.

Hãy xem các ví dụ sau để biết thông tin chi tiết.

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

  MapsInitializer.initialize(getApplicationContext(), Renderer.LATEST,
      new OnMapsSdkInitializedCallback() {
        @Override
        public void onMapsSdkInitialized(Renderer renderer) {
          switch (renderer) {
            case LATEST:
              Log.i("maps_renderer", "LATEST renderer");
              break;
            case LEGACY:
              Log.i("maps_renderer", "LEGACY renderer");
              break;
          }

          initializeConsumerSdk();
        }
      });
}

fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)
  setContentView(R.layout.main)
  initViews()

  MapsInitializer.initialize(
    getApplicationContext(), Renderer.LATEST,
    object : OnMapsSdkInitializedCallback() {
      fun onMapsSdkInitialized(renderer: Renderer?) {
        when (renderer) {
          LATEST -> Log.i("maps_renderer", "LATEST renderer")
          LEGACY -> Log.i("maps_renderer", "LEGACY renderer")
        }
        initializeConsumerSdk()
      }
    })
  }

Ghi chú về SSL/TLS

Trong nội bộ, việc triển khai SDK người tiêu dùng sử dụng SSL/TLS để giao tiếp an toàn với dịch vụ Fleet Engine. API Android phiên bản 23 trở xuống có thể yêu cầu bản vá SecurityProvider để giao tiếp với máy chủ. Để biết thêm thông tin về cách làm việc với SSL trong Android, hãy xem phần Trình cung cấp GMS bảo mật. Bài viết này cũng chứa các mã mẫu để vá trình cung cấp dịch vụ bảo mật.

Bước tiếp theo

Thiết lập bản đồ