Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jeremy-ellis-tech/xamarin.android.skobbler

C# bindings for the Skobbler Android SDK
https://github.com/jeremy-ellis-tech/xamarin.android.skobbler

android android-sdk c-sharp maps skobbler-sdk xamarin

Last synced: about 2 months ago
JSON representation

C# bindings for the Skobbler Android SDK

Host: GitHub
URL: https://github.com/jeremy-ellis-tech/xamarin.android.skobbler
Owner: jeremy-ellis-tech
License: mit
Created: 2014-12-27T19:26:09.000Z (about 10 years ago)
Default Branch: master
Last Pushed: 2016-12-31T23:12:34.000Z (about 8 years ago)
Last Synced: 2023-10-20T20:43:34.974Z (about 1 year ago)
Topics: android, android-sdk, c-sharp, maps, skobbler-sdk, xamarin
Language: C#
Homepage:
Size: 138 MB
Stars: 15
Watchers: 10
Forks: 4
Open Issues: 3
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        Xamarin.Android.Skobbler v3.0.2

========================

## C#  bindings for the Skobbler Android SDK ##

I am not associated with either [Skobbler](http://www.skobbler.com/) or [Xamarin .inc](http://xamarin.com/). All rights belong to their respective owners.

This repository includes a C# translation of the demo included with the Skobbler SDK. This currently has a few small bugs which are probably a result of my [mis]translation. Raise an issue or send a pull request if you would like these fixed ASAP. (You'll need to paste your API key into the android manifest before running the SDK demo)

## Installation ##

1. Clone the repo.

2. Build the Skobbler.Binding project. You'll need to set your jdk to `jdk1.8.0_102` or above & have `SDK build-tools v24.0.1` or above installed via the Android SDK manager.

3. Reference "Skobbler.dll" from your project; found under `"Xamarin.Android.Skobbler\src\Skobbler\bin\[Debug|Release][-$ABI]\Skobbler.dll"`

There are platform configurations for each native library ABI (`x86`, `armeabi-v7a` & `armeabi`). The `AnyCPU` platform configuration includes all 3 ABIs at the cost of a larger assembly (~5MB for specific platforms and ~12MB for AnyCPU). If you don't know which platform to select just use `AnyCPU`.

**The Skobbler sdk requires you to have a string resource called "app_name", which your manifest's application label points at. If you do not add this your app will crash on initialization.**

ie. in `Resources\values\Strings.xml`

    

    	...

      AndroidOpenSourceDemo

		...

    

and in `Properties\AndroidManifest.xml`

    

    

    	

      ...

    

## Documentation ##

Fantastic documentation is [available from Skobbler](http://developer.skobbler.com/getting-started/android). The main difference you will find is that get/set method pairs in Java have been changed to  C# properties. The automatic binding generation process will also add events that correspond to callback interfaces.

## Assets ##

You will need to manually copy the SKMaps.zip file to your assets folder, with a build configuration of an Android asset. The zip is available in the Android SDK from [Skobbler](http://developer.skobbler.com/support#download). See the demo app for an example.

## Additions & Alterations ##

I have added `async/await` methods to make things cleaner and more .NET friendly should you wish to use them. Here's an example using `NearbySearchAsync()` instead of `NearbySearch()`:

    try

    {

    	var searchManager = new SKSearchManager(); //No listener needed in the constructor for async calls;

    	IList results = await searchManager.NearbySearchAsync(searchObj);

    }

	catch(SKSearchStatusException)

	{

		//Catch invalid search status here.

	}

Namespaces should be the same as their respective Java packages, except the `com` prefix and are PascalCased.

## Demo App Screenshots ##

![Map Activity](docs/Screenshots/MapActivity.png)

![Map Styles](docs/Screenshots/MapStyleNight.png)

![Simulated Navigation](docs/Screenshots/Navigation.png)

![Real Reach](docs/Screenshots/RealReach.png)

![Heat Map](docs/Screenshots/HeatMap.png)

![Map Overlays](docs/Screenshots/MapOverlays.png)

## Contributing ##

If you would like to add a feature or fix a known issue, please add any contributions to a feature branch from `develop` and raise a pull request.

## License ##

The Bindings, SDKTools and SDKDemo are provided under the MIT license. See LICENSE for details.

## Thanks ##

[Skobbler](http://www.skobbler.com/)

[Open Street Maps](http://www.openstreetmap.org/)

[Xamarin inc.](http://xamarin.com/)