BingRestMapProvider

Initializes a new instance of the BingRestMapProvider class with default settings and configures tile downloading and caching.

Gets or sets the Bing Maps API key used for authenticating requests to Bing Maps services and enabling premium features.

Gets or sets the cache provider instance used for storing and retrieving map tiles from local storage.

public IMapCacheProvider CacheProvider { get; set; }

Implements: IMapTileProvider.CacheProvider

Gets or sets the culture information used for localizing map content, search results, and routing instructions.

Gets or sets a value indicating whether tile caching is enabled for storing downloaded tiles locally to improve performance.

public bool EnableCaching { get; set; }

Implements: IMapTileProvider.EnableCaching

Gets the unique identifier for this Bing Maps provider instance.

public string Id { get; }

Implements: IMapProvider.Id

Gets or sets the Bing Maps imagery set that determines the visual style and content type of map tiles displayed.

Gets or sets a value indicating whether this BingRestMapProvider has completed initialization and is ready for service calls.

Gets or sets a value indicating whether this BingRestMapProvider is currently performing initialization operations.

Gets or sets the maximum zoom level supported by this Bing Maps provider for tile requests and map display.

public int MaxZoomLevel { get; set; }

Implements: IMapProvider.MaxZoomLevel

Gets or sets the minimum zoom level supported by this Bing Maps provider for tile requests and map display.

public int MinZoomLevel { get; set; }

Implements: IMapProvider.MinZoomLevel

Gets the unique session identifier obtained from Bing Maps logging service for optimized API usage and cost reduction.

Gets the settings that control tile rendering behavior.

public MapTileProviderSettings Settings { get; }

Implements: IMapTileProvider.Settings

Gets or sets the tile downloader instance responsible for asynchronously downloading map tiles from Bing Maps service.

public IMapTileDownloader TileDownloader { get; set; }

Implements: IMapTileProvider.TileDownloader

Gets the standard tile size in pixels used by this Bing Maps provider for all tile requests and rendering operations.

public Size TileSize { get; }

Implements: IMapTileProvider.TileSize

Gets or sets a value indicating whether to use session-based authentication for improved performance and reduced transaction costs.

Constructs the Bing Maps elevation request URI based on the elevation request parameters and elevation type settings.

Constructs the Bing Maps routing request URI based on the route request parameters and travel mode settings.

Constructs the Bing Maps search request URI based on the search request parameters and localization settings.

Constructs the JSON request body for truck routing containing waypoints, vehicle specifications, and routing options.

Constructs the Bing Maps truck routing request URI with authentication parameters for the truck routing service.

Performs an asynchronous elevation calculation using Bing Maps elevation services with the specified elevation request parameters.

public void CalculateElevationAsync(ElevationRequest request)

Implements: IMapElevationProvider.CalculateElevationAsync(ElevationRequest)

Performs an asynchronous route calculation using Bing Maps routing services with the specified route request parameters.

public void CalculateRouteAsync(RouteRequest request)

Implements: IMapRouteProvider.CalculateRouteAsync(RouteRequest)

Performs an asynchronous truck route calculation using Bing Maps truck routing services with vehicle specifications and restrictions.

public void CalculateTruckRouteAsync(TruckRouteRequest request)

Implements: IMapTruckRouteProvider.CalculateTruckRouteAsync(TruckRouteRequest)

Creates a deep copy of this BingRestMapProvider instance with all configuration settings and metadata information.

public object Clone()

Implements: ICloneable.Clone()

Generates a unique cache key string for storing and retrieving tile images based on coordinates, zoom level, and imagery set.

Generates map visual elements for the specified viewport by converting cached tile images into renderable map tile elements.

public virtual IEnumerable<MapVisualElement> GetContent(IMapViewport viewport)

Implements: IMapProvider.GetContent(IMapViewport)

Converts a list of geographic points into a comma-separated string format for use in elevation API requests.

Retrieves a list of supported map views based on available Bing Maps imagery sets with localized names and selection state.

public virtual List<MapViewInfo> GetSupportedViews()

Implements: IMapProvider.GetSupportedViews()

Constructs the URI for retrieving a specific map tile from Bing Maps service using tile matrix coordinates and zoom level.

Synchronously retrieves a tile image from Bing Maps service or cache using the specified tile matrix coordinates and zoom level.

public Image GetTileImage(int tileMatrixX, int tileMatrixY, int zoomLevel)

Implements: IMapTileProvider.GetTileImage(int, int, int)

Retrieves the tile image for the specified TileInfo either from cache or by downloading from Bing Maps service.

Initializes this Bing Maps provider by establishing session authentication and retrieving imagery metadata for tile operations.

public virtual void Initialize()

Implements: IMapProvider.Initialize()

Handles the completion of imagery metadata initialization by processing service response and configuring tile size and zoom levels.

Initializes the Bing Maps imagery service by retrieving metadata information for the current imagery set and configuring tile parameters.

Handles the completion of session initialization by extracting the session ID and proceeding to initialize imagery services.

Raises the CalculateElevationCompleted event to notify subscribers that an elevation calculation has finished successfully.

Handles the completion of elevation calculation by processing the JSON response and extracting elevation or sea level data.

Raises the CalculateElevationError event to notify subscribers that an elevation calculation has encountered an error.

Handles the completion of route calculation by processing the JSON response and extracting route information.

Raises the CalculateRouteCompleted event to notify subscribers that a route calculation has finished successfully.

Raises the CalculateRouteError event to notify subscribers that a route calculation has encountered an error.

Handles the completion of truck route calculation by processing the JSON response and extracting truck route information.

Raises the CalculateTruckRouteCompleted event to notify subscribers that a truck route calculation has finished successfully.

Raises the CalculateTruckRouteError event to notify subscribers that a truck route calculation has encountered an error.

Handles the completion of asynchronous file loading from cache and initiates tile download if cache content is unavailable.

Raises the InitializationComplete event to notify subscribers that provider initialization has finished.

Raises the InitializationError event to notify subscribers that provider initialization has failed.

Raises the ProviderUpdated event to notify subscribers that provider content has changed.

Raises the SearchCompleted event to notify subscribers that a search operation has finished successfully.

Raises the SearchError event to notify subscribers that a search operation has encountered an error.

Handles the completion of search requests by processing the JSON response and extracting location information using multiple encoding strategies.

Handles tile download completion events, manages cache storage, and updates wraparound tiles with downloaded content.

Performs an asynchronous search operation using Bing Maps search services with the specified search request parameters.

public void SearchAsync(SearchRequest request)

Implements: IMapSearchProvider.SearchAsync(SearchRequest)

Sets the active map view by configuring the imagery set based on the specified view information and label settings.

public virtual void SetView(MapViewInfo view)

Implements: IMapProvider.SetView(MapViewInfo)

Responds to viewport changes by calculating visible tiles, managing tile downloads, and updating the tile matrix for rendering.

public void ViewportChanged(IMapViewport viewport, ViewportChangeAction action)

Implements: IMapProvider.ViewportChanged(IMapViewport, ViewportChangeAction)

Occurs when an elevation calculation operation has completed successfully with elevation results.

public event EventHandler<ElevationCompletedEventArgs> CalculateElevationCompleted

Implements: IMapElevationProvider.CalculateElevationCompleted

Occurs when an elevation calculation operation encounters an error during execution.

public event EventHandler<CalculateElevationErrorEventArgs> CalculateElevationError

Implements: IMapElevationProvider.CalculateElevationError

Occurs when a route calculation operation has completed successfully with routing results.

public event EventHandler<RoutingCompletedEventArgs> CalculateRouteCompleted

Implements: IMapRouteProvider.CalculateRouteCompleted

Occurs when a route calculation operation encounters an error during execution.

public event EventHandler<CalculateRouteErrorEventArgs> CalculateRouteError

Implements: IMapRouteProvider.CalculateRouteError

Occurs when a truck route calculation operation has completed successfully with truck routing results.

public event EventHandler<RoutingCompletedEventArgs> CalculateTruckRouteCompleted

Implements: IMapTruckRouteProvider.CalculateTruckRouteCompleted

Occurs when a truck route calculation operation encounters an error during execution.

public event EventHandler<CalculateRouteErrorEventArgs> CalculateTruckRouteError

Implements: IMapTruckRouteProvider.CalculateTruckRouteError

Occurs when the Bing Maps provider has completed its initialization process and is ready for use.

public event EventHandler InitializationComplete

Implements: IMapProvider.InitializationComplete

Occurs when provider initialization encounters an error during setup.

public event InitializationErrorEventHandler InitializationError

Implements: IMapProvider.InitializationError

Occurs when the provider content has been updated with new tile data or configuration changes.

public event EventHandler ProviderUpdated

Implements: IMapProvider.ProviderUpdated

Occurs when a search operation has completed successfully with search results.

public event EventHandler<SearchCompletedEventArgs> SearchCompleted

Implements: IMapSearchProvider.SearchCompleted

Occurs when a search operation encounters an error during execution.

public event EventHandler<SearchErrorEventArgs> SearchError

Implements: IMapSearchProvider.SearchError