ExternalMapDataSourceClient

public class ExternalMapDataSourceClient
extension ExternalMapDataSourceClient: NativeBase
extension ExternalMapDataSourceClient: Hashable

Note: This is a beta release of this feature, so there could be a few bugs and unexpected behaviors. Related APIs may change for new releases without a deprecation process.

  • Creates a new instance of this class.

    Throws

    InstantiationError Indicates what went wrong when the instantiation was attempted.

    Declaration

    Swift

    public init() throws

  • 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 ConfigureConnectionHandle.

    Declaration

    Swift

    public func configureRemoteConnectionAsync(url: String, engine: SDKNativeEngine, credentials: SslClientCredentialsOptions?, callback: @escaping ConfigureConnectionHandle) -> TaskHandle

    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 ExternalMapDataSource.start(String, SDKNativeEngine, SslServerCredentialsOptions?)
    engine

    Instance of an existing SDKNativeEngine.
    credentials
    callback

    Protocol to retrieve an operation status on the main thread.

    Return Value

    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!