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ụ thích hợp và SDK người tiêu dùng 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

Tải 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 của người 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 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õ ràng bằng cách sử dụng MapsInitializer.initialize().

* Với việc phát hành Trình kết xuất Maps mới, trình kết xuất đồ hoạ 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 một thành phần hiển thị chứa GoogleMapView hoặc ConsumerMapView.

• Đang đặ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 và chế độ xem bản đồ sẽ được trình kết xuất mặc định hiển thị.

Chạy SDK Maps trước khi khởi chạy SDK người tiêu dùng

1. Trong lớp Application hoặc Activity khởi động, 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 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()
      }
    })
  }

Lưu ý về SSL/TLS

Trong nội bộ, quá trình triển khai SDK dành cho người dùng sử dụng SSL/TLS để giao tiếp một cách an toàn với dịch vụ Công cụ của đội xe. 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 đồ