Method Details

• configureRemoteConnectionAsync

  @NonNull public TaskHandle configureRemoteConnectionAsync(@NonNull String url, @NonNull SDKNativeEngine engine, @Nullable SslClientCredentialsOptions credentials, @NonNull ConfigureConnectionCallback callback)

  Initialize SDKNativeEngine with URL of the remote map data source gRPC server. Newly injected map data source replaces exiting one if SDKNativeEngine was already connected. Suggested configuration is taken from SDKOptions.catalogConfigurations, actual catalog versions are queried from the remote connection in order to be in sync. It is a non-blocking function, and the result will be returned via a callback ConfigureConnectionCallback.

  Parameters:

  url -

  URL to connect with the remote map data source gRPC server. The remote map data source gRPC server could be self managed service created with help OCM Access Manager (OCM AM) or service exposed using ExternalMapDataSourceServer.start(java.lang.String, com.here.sdk.core.engine.SDKNativeEngine, com.here.sdk.maploader.remote.connection.SslServerCredentialsOptions, com.here.sdk.maploader.remote.connection.ServerStartedCallback)

  engine -

  Instance of an existing SDKNativeEngine.

  credentials -

  Instance of SslClientCredentialsOptions

  callback -

  Callback to retrieve an operation status on the main thread.

  Returns:

  Handle that will be used to manipulate the execution of the task, for example, to cancel on ongoing request. NOTE: Cancelation functionality has not implemented yet!