Merge pull request #6 from arnaudleclerc/releases/0.3.0

Releases/0.3.0

Author: arnaudleclerc

.github/workflows/CI.yml

@@ -12,7 +12,7 @@ on:
   pull_request:
     branches: 
       - develop
-      - master
+      - main
     paths:
       - src/**
       - tests/**

README.md

@@ -1,4 +1,4 @@
-![Nuget](https://img.shields.io/nuget/v/AzureMapsControl.Components) ![Nuget (with prereleases)](https://img.shields.io/nuget/vpre/AzureMapsControl.Components) ![CI](https://github.com/arnaudleclerc/AzureMapsControl.Components/workflows/CI/badge.svg?branch=develop) ![release](https://github.com/arnaudleclerc/AzureMapsControl.Components/workflows/release/badge.svg?branch=develop)
+![Nuget](https://img.shields.io/nuget/v/AzureMapsControl.Components) ![Nuget (with prereleases)](https://img.shields.io/nuget/vpre/AzureMapsControl.Components) ![CI](https://github.com/arnaudleclerc/AzureMapsControl.Components/workflows/CI/badge.svg) ![release](https://github.com/arnaudleclerc/AzureMapsControl.Components/workflows/release/badge.svg)
 
 This library allows you to use `Azure Maps` inside your razor application.
 

docs/layers/bubblelayer/README.md

@@ -22,7 +22,7 @@ The `Bubble Layer` requires a data source. The ID of the datasource to bind to t
     {
         const string dataSourceId = "bubbleDataSource";
         var dataSource = new AzureMapsControl.Components.Data.DataSource(dataSourceId);
-        await events.Map.AddDataSourceAsync(dataSource);
+        await events.Map.AddSourceAsync(dataSource);
 
 
         var geometries = new List<AzureMapsControl.Components.Atlas.Geometry>();

docs/layers/heatmaplayer/README.md

@@ -23,7 +23,7 @@ The `Heatmap Layer` requires a data source. The ID of the datasource to bind to
     {
         const string dataSourceId = "heatmapDataSource";
         var dataSource = new AzureMapsControl.Components.Data.DataSource(dataSourceId);
-        await events.Map.AddDataSourceAsync(dataSource);
+        await events.Map.AddSourceAsync(dataSource);
         await dataSource.ImportDataFromUrlAsync("https://services1.arcgis.com/0MSEUqKaxRlEPj5g/arcgis/rest/services/ncov_cases/FeatureServer/1/query?where=1%3D1&f=geojson&outFields=*");
 
         var layer = new AzureMapsControl.Components.Layers.HeatmapLayer

docs/layers/linelayer/README.md

@@ -28,7 +28,7 @@ A line layer can be used to render `LineString` and `MultiLineString` features a
                 LineMetrics = true
             }
         };
-        await events.Map.AddDataSourceAsync(dataSource);
+        await events.Map.AddSourceAsync(dataSource);
 
         await dataSource.AddAsync(new AzureMapsControl.Components.Atlas.LineString(new[] {
             new AzureMapsControl.Components.Atlas.Position(11.575454, 48.137392),

docs/layers/polygonextrusionlayer/README.md

@@ -22,7 +22,7 @@ The polygon extrusion layer renders areas of `Polygon` and `MultiPolygon` featur
     {
         const string dataSourceId = "dataSource";
         var dataSource = new AzureMapsControl.Components.Data.DataSource(dataSourceId);
-        await events.Map.AddDataSourceAsync(dataSource);
+        await events.Map.AddSourceAsync(dataSource);
 
         await dataSource.ImportDataFromUrlAsync("https://raw.githubusercontent.com/arnaudleclerc/ng-azure-maps/master/assets/data/countries.geojson.json");
 

docs/layers/polygonlayer/README.md

@@ -20,7 +20,7 @@ A Polygon Layer renders the areas of `Polygon` and `MultiPolygon` feature geomet
     {
         const string dataSourceId = "dataSource";
         var dataSource = new AzureMapsControl.Components.Data.DataSource(dataSourceId);
-        await events.Map.AddDataSourceAsync(dataSource);
+        await events.Map.AddSourceAsync(dataSource);
 
         var polygon = new AzureMapsControl.Components.Atlas.Polygon(new[]
         {

docs/layers/symbollayer/README.md

@@ -21,10 +21,10 @@ i
     public async Task OnMapReady(MapEventArgs events)
     {
         var blueDataSource = new AzureMapsControl.Components.Data.DataSource("blueDataSource");
-        await events.Map.AddDataSourceAsync(blueDataSource);
+        await events.Map.AddSourceAsync(blueDataSource);
 
         var redDataSource = new AzureMapsControl.Components.Data.DataSource("redDataSource");
-        await events.Map.AddDataSourceAsync(redDataSource);
+        await events.Map.AddSourceAsync(redDataSource);
 
         var bluePoints = new List<AzureMapsControl.Components.Atlas.Point>();
         var redPoints = new List<AzureMapsControl.Components.Atlas.Point>();

docs/sources/README.md

@@ -0,0 +1,16 @@
+## Sources
+
+Most of the layers require `sources` to read their data from. A source needs to be added on the `Map` and its ID needs to be provided on the options of the layer. It does not matter if the source or the layer is added first, the layer being refreshed whenever the source changes.
+
+Two types of sources are available :
+
+- [Data Source](./datasources)
+- [Vector Tile Source](./vectortilesources)
+
+## Add a source
+
+A source can be added to the map using the `AddSourceAsync` method.
+
+## Removing the data source
+
+A data source can be removed from the map using the `RemoveSourceAsync` method. A call to `ClearSourcesAsync` removes all the data sources from the map.

docs/datasources/README.md docs/sources/datasources/README.mddocs/datasources/README.md renamed to docs/sources/datasources/README.md

@@ -1,6 +1,4 @@
-## Data Sources
-
-Most of the layers require `data sources` to read their data from. A data source needs to be added on the `Map` and its ID needs needs to be provided on the options of the layer. It does not matter if the data source or the layer is added first, the layer being refreshed whenever the data source changes.
+A data source manages raw location data in GeoJSON format locally. Good for small to medium data sets (upwards of hundreds of thousands of shapes).
 
 ## Adding geometries
 
@@ -31,7 +29,7 @@ You can add geometry on a data source using the `AddAsync` method.
     {
         const string dataSourceId = "bubbleDataSource";
         var dataSource = new AzureMapsControl.Components.Data.DataSource(dataSourceId);
-        await events.Map.AddDataSourceAsync(dataSource);
+        await events.Map.AddSourceAsync(dataSource);
 
 
         var geometries = new List<AzureMapsControl.Components.Atlas.Geometry>();
@@ -80,7 +78,7 @@ You can import data on the data source using the `ImportDataFromUrlAsync` method
     {
         const string dataSourceId = "heatmapDataSource";
         var dataSource = new AzureMapsControl.Components.Data.DataSource(dataSourceId);
-        await events.Map.AddDataSourceAsync(dataSource);
+        await events.Map.AddSourceAsync(dataSource);
         await dataSource.ImportDataFromUrlAsync("https://services1.arcgis.com/0MSEUqKaxRlEPj5g/arcgis/rest/services/ncov_cases/FeatureServer/1/query?where=1%3D1&f=geojson&outFields=*");
 
         var layer = new AzureMapsControl.Components.Layers.HeatmapLayer
@@ -111,8 +109,4 @@ Geometries can be removed from the data source using the `RemoveAsync` method.
 
 ## Clear the data source
 
-The data source can be cleared using the `ClearAsync` method. This will remove all the geometries from the data source.
-
-## Removing the data source
-
-A data source can be removed from the map using the `RemoveDataSourceAsync` method. A call to `ClearDataSourcesAsync` removes all the data sources from the map.
+The data source can be cleared using the `ClearAsync` method. This will remove all the geometries from the data source.