chore: update readme file, add breaking changes file

Author: LProulx86

BREAKING_CHANGES.md

@@ -1,17 +1,53 @@
 # Cartography
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg?style=flat-square)](LICENSE)![Version](https://img.shields.io/nuget/v/Cartography.DynamicMap?style=flat-square)![Downloads](https://img.shields.io/nuget/dt/Cartography.DynamicMap?style=flat-square)   
 
-Nventive solution for mobile app map.
+Cartography provides you 3 map related libraries for IOS, Android and windows using native map of each platform.
 
-[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)
+## **Cornerstones**
+ - Add native map to your app.
+ - If needed, Google map can be use on all platform.
+ - The solution generate three independant nuget.
 
 ## Getting Started
 
 ### **Samples**
 - Clone project a sample is available.
 - For seeing samples, build and install app with VS on the desire device (Android, IOS, or UWP)
 
- 
-## **DynamicMap**
+### API Key (not needed for mapService)
+- For Google map (Android), you need to [create your Api Key](https://developers.google.com/maps/documentation/javascript/get-api-key)
+- For Bing map, you should need a [Bing Api Key](https://learn.microsoft.com/en-us/bingmaps/getting-started/bing-maps-dev-center-help/getting-a-bing-maps-key) but work fine without it in sample.
+
+set it in : sample.shared => Constants.
+
+```csharp
+public class GoogleMaps
+{
+	//TODO: Get new API Key
+	public const string ApiKey = "";
+}
+```  
+
+### **DynamicMap**
+
+- Setup your permission, in your AssemblyInfo of Android. 
+- For windows location is in Package.appxmanifest under capabilities, select Location and Internet(Client). 
+
+```csharp
+//optional, if you need to locate user.
+[assembly: UsesPermission(Android.Manifest.Permission.AccessFineLocation)]
+[assembly: UsesPermission(Android.Manifest.Permission.AccessCoarseLocation)]
+
+//Required, replace AppName by your Application Name.
+[assembly: UsesPermission("AppName.permission.MAPS_RECEIVE")]
+[assembly: Permission(Name = "AppName.permission.MAPS_RECEIVE", ProtectionLevel = Android.Content.PM.Protection.Signature)]
+
+[assembly: UsesPermission("com.google.android.providers.gsf.permission.READ_GSERVICES")]
+
+[assembly: MetaData("com.google.android.maps.v2.API_KEY", Value = Constants.GoogleMaps.ApiKey)]
+
+```
+
 - Add Cartography.DynamicMap NuGet package to your project.
 - In your ViewModel :
 ```csharp
@@ -39,7 +75,7 @@ using Cartography.DynamicMap
 - Control can be added to your map : See [DynamicMapControl](Documentation/DynamicMapControl.md)
 
  
-## **StaticMap**
+### **StaticMap**
 - Add Cartography.StaticMap NuGet package to your project.
 - In your ViewModel :
 ```csharp
@@ -57,7 +93,7 @@ using Cartography.StaticMap
 - Add Style StaticMapControl : see https://github.com/nventive/Cartography/blob/master/Samples/Samples/Samples.Shared/Views/Styles/StaticMapControl.xaml
 
  
-## **MapService**
+### **MapService**
 - Add Cartography.MapService NuGet package to your project.
 - In your ViewModel :
 ```csharp
@@ -137,15 +173,16 @@ OR
 2.	`Direction` : Open user default map service and show direction from User location to somewhere.
 
 
-## Changelog
+## Breaking Changes
+
+Please consult the [BREAKING CHANGES](BREAKING_CHANGES.md) for the list of breaking changes.
 
 Please consult the [CHANGELOG](CHANGELOG.md) for more information about version
 history.
 
 ## License
 
-This project is licensed under the Apache 2.0 license - see the
-[LICENSE](LICENSE) file for details.
+This project is licensed under the [Apache 2.0 license](LICENSE).
 
 ## Contributing