Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/amay077/xamarin.forms.googlemaps

Map library for Xamarin.Forms using Google maps API
https://github.com/amay077/xamarin.forms.googlemaps

andriod c-sharp google-maps ios uwp xamarin xamarin-forms

Last synced: about 1 month ago
JSON representation

Map library for Xamarin.Forms using Google maps API

Host: GitHub
URL: https://github.com/amay077/xamarin.forms.googlemaps
Owner: amay077
License: mit
Created: 2016-06-19T08:31:18.000Z (over 8 years ago)
Default Branch: master
Last Pushed: 2024-04-05T11:15:10.000Z (7 months ago)
Last Synced: 2024-04-30T02:22:07.077Z (7 months ago)
Topics: andriod, c-sharp, google-maps, ios, uwp, xamarin, xamarin-forms
Language: C#
Homepage: https://www.nuget.org/packages/Xamarin.Forms.GoogleMaps/
Size: 4.74 MB
Stars: 543
Watchers: 55
Forks: 339
Open Issues: 168
Metadata Files:
- Readme: README-ja.md
- Contributing: CONTRIBUTING-ja.md
- License: LICENSE.txt
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        ## ![logo](logo.png) Xamarin.Forms.GoogleMaps 

![](https://img.shields.io/nuget/v/Xamarin.Forms.GoogleMaps.svg) ![](https://img.shields.io/nuget/dt/Xamarin.Forms.GoogleMaps.svg) [![Gitter chat](https://badges.gitter.im/gitterHQ/gitter.png)](http://gitter.im/Xamarin-Forms-GoogleMaps/public) [![donate/kyash](https://img.shields.io/badge/donate-kyash-orange.svg)](#寄付)

[English README is here！](README.md)

Xamarin.Forms 用の Googleマップライブラリです。

[Xamarin.Forms.Maps](https://github.com/xamarin/Xamarin.Forms) をフォークして作っているので、使い方はほとんど同じです。

## デモアプリ

このライブラリの全ての機能が試せるデモアプリを以下より配信しています。このアプリのソースは [XFGoogleMapSample](https://github.com/amay077/Xamarin.Forms.GoogleMaps/tree/master/XFGoogleMapSample) です。

* [Android DEMO Apps](https://install.mobile.azure.com/users/okuokuoku/apps/xfgooglemapsample/distribution_groups/trial) - このリンクをAndroidのブラウザで開いてください

* iOS DEMO Apps - [Gitter](https://gitter.im/Xamarin-Forms-GoogleMaps/public) かなにかでリクエストしてください（デバイスのUUIDを教えてもらう必要があります）

![screenshot](screenshot01.png)

## なぜこれを作った

Xamarin公式の地図ライブラリ [Xamarin.Forms.Maps](https://developer.xamarin.com/guides/xamarin-forms/user-interface/map/) は、非常に機能が少ないです（Googleマップ、Appleマップ、Bingマップで機能を共通化するのはとても難しいのでしょう）。

特に感じるのは、BingマップSDKがとてもチープなことです。ベクトルタイルでもないし、マーカーの吹き出し(InfoWindow

)も無いようです。モバイルアプリの市場のほとんどは Android と iOS なのに、Bingマップのサポートは必要ないように感じます。また、iOS でも Appleマップ よりも Googleマップ を使用した方が、 Android/iOS で共通化しやすいと感じます。

このライブラリは、メインターゲットを iOS と Android だけに限定し、Xamarin.Forms.Maps でできない機能を実現するために作りました。

異なる地図SDKで実現可能な最小限の機能しか持たない Xamarin.Forms.Maps に対して、 **同じ Google Maps で多くの共通機能を実現できるのが Xamarin.Forms.GoogleMaps です。**

## Xamarin.Forms.Maps との比較

|機能|X.F.Maps|X.F.GoogleMaps|

| ------------------- | :-----------: | :-----------: |

|地図の種類|Yes|Yes|

|渋滞状況地図|-|Yes|

|地図イベント|-|Yes|

|地図の移動(アニメーション付き)|Yes|Yes|

|地図の移動(アニメーション無し)|-|Yes|

|ピン|Yes|Yes|

|カスタムピン|-|Yes|

|ピンのドラッグ&ドロップ|-|Yes|

|ポリゴン|-|Yes|

|ライン|-|Yes|

|円|-|Yes|

|カスタム地図タイル|-|Yes|

詳しくは、[Xamarin.Forms.Maps との比較](https://github.com/amay077/Xamarin.Forms.GoogleMaps/wiki/Xamarin.Forms.Maps との比較) を見て下さい。

## セットアップ

* Available on NuGet: https://www.nuget.org/packages/Xamarin.Forms.GoogleMaps/ [![NuGet](https://img.shields.io/nuget/v/Xam.Plugin.Geolocator.svg?label=NuGet)](https://www.nuget.org/packages/Xamarin.Forms.GoogleMaps/)

* PCLプロジェクトと各プラットフォームプロジェクトにインストールしてください

## サポートするプラットフォーム

|Platform|Supported|

| ------------------- | :-----------: |

|iOS Unified|Yes|

|Android|Yes|

|Windows 10 UWP|No|

|その他|No|

## 使い方

* [Map Control - Xamarin](https://developer.xamarin.com/guides/xamarin-forms/user-interface/map/)

* [Xamarin.Formsで地図を表示するには？（Xamarin.Forms.Maps使用） - Build Insider](http://www.buildinsider.net/mobile/xamarintips/0039)

とほぼ同じです。

初期化メソッドが ``Xamarin.Forms.Maps.Init()`` から ``Xamarin.Forms.GoogleMaps.Init()`` に変更になっています。

iOS の場合、 [Google Maps API for iOS](https://developers.google.com/maps/documentation/ios-sdk/) の API キーを取得し、``AppDelegate.cs`` にて ``Init`` に渡してください。

```csharp

[Register("AppDelegate")]

public partial class AppDelegate : global::Xamarin.Forms.Platform.iOS.FormsApplicationDelegate

{

    public override bool FinishedLaunching(UIApplication app, NSDictionary options)

    {

        global::Xamarin.Forms.Forms.Init();

        Xamarin.FormsGoogleMaps.Init("your_api_key");

        LoadApplication(new App());

        return base.FinishedLaunching(app, options);

    }

}

``` 

既定の名前空間が ``Xamarin.Forms.Maps`` から ``Xamarin.Forms.GoogleMaps`` に変更されています。他のAPIはすべて同じです。

サンプルプログラムが、

* [XFGoogleMapSample](https://github.com/amay077/Xamarin.Forms.GoogleMaps/tree/master/XFGoogleMapSample)

にあります。

## 採用事例

Xamarin.Forms.GoogleMaps が使われているアプリを紹介します(他にもあったら [教えてください](https://github.com/amay077/Xamarin.Forms.GoogleMaps/issues/512))。

  

    

      
HereNow

      

      by CINRA, Inc.

    

    

      CityBee

      

       

    

    

      Rentacarss Araç Takip

      

       

    

    

      yakala.co

      iOS

       / Android

      

      by Dakicksoft

    

  

  

    

      TransantiagoMaster

      

    

    

    

    

      CmsApp

      iOS

       / Android

      

      by Ruben Carreon

    

    

      UsynligO

      iOS

       / Android

      

      by Trond Benum

    

  

  

    

      Taiwan-AskFaceMask (問口罩)

      iOS

       / Android

      

      by JamestsaiTW

    

    

      Bipbip Navigation GPS

      iOS

       / Android

      

      by Bipbip

    

    

      eLandFly

      iOS

       / Android

      

      by elandfly.com            

    

    

    

    

## リリースノーツ

[Releases](https://github.com/amay077/Xamarin.Forms.GoogleMaps/releases) または [RELEASE_NOTES](RELEASE_NOTES.md) を見てください。

## 今後の予定

なるべく Xamarin.Forms.Maps の API に準じ、Google Maps固有の機能のみ API を追加するつもりです。 

機能要望は、 [@amay077](https://twitter.com/amay077) または、ISSUE やプルリクください！

追加機能案は以下の通りです。

* ~~Pin の InfoWindow の Visible プロパティ~~ v1.0.0で対応

* ~~Pin のタップ＆ホールドによる移動~~ v1.5.0で対応

* ~~Polygon, Polyline, Circle の描画サポート~~ v1.1.0で対応

* [その他の機能改善リスト](https://github.com/amay077/Xamarin.Forms.GoogleMaps/labels/enhancement)

Windows 10 UWP 対応は v5.0.0 から削除しました。

Android/iOS のみ対応します。

## CONTRIBUTION

私たちは、Xamarin.Forms.GoogleMaps への、あなたの貢献に大変感謝します。

開発に参加して頂ける方は、[コントリビューション ガイドライン](CONTRIBUTING-ja.md) を読んで下さい。

## 寄付

Xamarin.Forms.GoogleMaps 開発の継続のため、寄付を募集しています。

**Gumroad**

* [Gumroad](https://amay077.gumroad.com/)

あなたの寄付で開発者のモチベーションが上がります、どうかよろしくおねがいします :sushi:

## ライセンス

[LICENSE](LICENSE.txt) をみて下さい。

logo.png by [alecive](http://www.iconarchive.com/show/flatwoken-icons-by-alecive.html) - [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/deed)