Protocols

Common protocol for every geometry type.

Represents point of the route received in response from route planning API

LoggerOutput - Shall be used to create custom log outputs like, file or cloud.

Map tile provider interface for map display.

HTTPHandlerRequestProtocol declares method required to send http request.

HTTPHandlerResponseDecoder allows Data be decoded into the given T.Type.

Example:

class JSONResponseDecoder: HTTPHandlerResponseDecoder {
    public func decode<T>(_ type: T.Type, from data: Data) throws -> T where T: Decodable {
        let jsonDecoder = JSONDecoder()
        return try jsonDecoder.decode(type, from: data)
    }
}

HTTPRequestBodyCreator allows HTTPHandlerRequestProtocol to be mapped to Data that will be injected into an http request body.

Example:

public class JSONBodyCreator: HTTPRequestBodyCreator {
    public init() {}

    public func buildBody(request: HTTPHandlerRequestProtocol) throws -> Data? {
        guard let parameters = request.parameters(), request.method() != "GET" else { return nil }
        return parameters.jsonData()
    }
}

AdditionalQueryItemProvider allows an additional URLQueryItem to be injected into an HTTPHandlerRequestProtocol.

QueryItemConvertible allows Any become a URLQueryItem

Example:

“``extension String: QueryItemConvertible { public func queryItem(key: String) -> URLQueryItem? { .init(name: key, value: self) } }

- Important: This is a Public Preview API. It may be changed or removed at any time.

QueryItemConvertible allows Any become an array of URLQueryItems

Example that allows an array of SectionTypes become an array of URLQueryItems

extension SectionType: QueryItemConvertible {
    public func queryItem(key: String) -> URLQueryItem? {
        guard let value = value else { return nil }
        return .init(name: key, value: value)
    }
}

extension Array: QueryItemArrayConvertible where Element == SectionType {
    public func queryItems(key: String) -> [URLQueryItem]? {
        guard count > 0 else { return nil }
        return compactMap { $0.value }.map { URLQueryItem(name: key, value: $0) }
    }
}

Provides information about what conversion parameters should be used for input value within a specific range