Getting started

Android

Add your Google Maps API key to your AndroidManifest.xml.

<meta-data android:name="com.google.android.maps.v2.API_KEY" android:value="YOUR API KEY" />

Following permissions should be added to your AndroidManifest.xml

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

If you plan to use the automatic route calculation, a valid key for the Google Maps Directions API is required. You can set it up anywhere in your PCL, simply call GmsDirection.Init("YOUR API KEY");.

If you plan to use the NativePlacesApi make sure you have a valid key for the Google Places API and set the key in your AndroidManifest.xml. Replace the following line

<meta-data android:name="com.google.android.maps.v2.API_KEY" android:value="YOUR API KEY" />

with

<meta-data android:name="com.google.android.geo.API_KEY" android:value="YOUR API KEY" />

Make sure you call

TKGoogleMaps.Init(this, bundle); 

Shared

Include namespace in your XAML file:

<ContentPage xmlns:tk="clr-namespace:TK.CustomMap;assembly=TK.CustomMap" />

Setup map:

<tk:TKCustomMap MapRegion="{Binding MapRegion}"
                IsShowingUser="{Binding IsShowingUser}"
                IsClusteringEnabled="{Binding IsClusteringEnabled}"
                Pins="{Binding Pins}"
                PinSelectedCommand="{Binding PinSelectedCommand}"
                PinDragEndCommand="{Binding PinDragEndCommand}"
                Routes="{Binding Routes}"
                RouteClickedCommand="{Binding RouteClickedCommand}"
                Polylines="{Binding Polylines}"
                Polygons="{Binding Polygons}"
                Circles="{Binding Circles}"
                TilesUrlOptions="{Binding TileOptions}"
                MapFunctions="{Binding MapFunctions}"
                SelectedPin="{Binding SelectedPin}"
                MapClickedCommand="{Binding MapClickedCommand}"
                MapLongPressCommand="{Binding MapLongPressCommand}"
                CalloutClickedCommand="{Binding CalloutClickedCommand}" />

Main features