diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md deleted file mode 100644 index b75b2385..00000000 --- a/CODE_OF_CONDUCT.md +++ /dev/null @@ -1,46 +0,0 @@ -# Contributor Covenant Code of Conduct - -## Our Pledge - -In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation. - -## Our Standards - -Examples of behavior that contributes to creating a positive environment include: - -* Using welcoming and inclusive language -* Being respectful of differing viewpoints and experiences -* Gracefully accepting constructive criticism -* Focusing on what is best for the community -* Showing empathy towards other community members - -Examples of unacceptable behavior by participants include: - -* The use of sexualized language or imagery and unwelcome sexual attention or advances -* Trolling, insulting/derogatory comments, and personal or political attacks -* Public or private harassment -* Publishing others' private information, such as a physical or electronic address, without explicit permission -* Other conduct which could reasonably be considered inappropriate in a professional setting - -## Our Responsibilities - -Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior. - -Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful. - -## Scope - -This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers. - -## Enforcement - -Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at okuokuoku@gmail.com. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately. - -Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership. - -## Attribution - -This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at [http://contributor-covenant.org/version/1/4][version] - -[homepage]: http://contributor-covenant.org -[version]: http://contributor-covenant.org/version/1/4/ diff --git a/CONTRIBUTING-ja.md b/CONTRIBUTING-ja.md deleted file mode 100644 index 24d1dad7..00000000 --- a/CONTRIBUTING-ja.md +++ /dev/null @@ -1,82 +0,0 @@ -# How to contribute - -[English contribution guideline is here!](CONTRIBUTING.md) - -我々は皆さんの Xamarin.Forms.GoogleMaps(以下、XF.GoogleMaps) へ貢献を歓迎します。 -我々は、皆さんによる貢献を出来るだけ簡単にできるようにしたいと考えています。 -その為に、貢献しようとする人は以下の方針に従うよう、お願いします。 - -## Getting Started - -* XF.GoogleMaps に貢献する為には [GitHub アカウント](https://github.com/signup/free) が必要です。 -* 問題や機能要望には Issue を作ってください(まだ Issue が作られていない場合)。 - * Issue や Pull request を送るのに、事前の連絡は必要ありません。 - * バグを issue で報告する場合、バグを再現する為の説明、エラーの情報、環境を書いてください。 - * Issue のタイトルと本文はできるだけ英語で書いてください(不可能な場合は日本語でも OK です)。 - * [Issue テンプレート](ISSUE_TEMPLATE.md) が用意されているので、必要な箇所を切り取って使用してください。 -* GitHub でリポジトリの fork を作ってください。 -* ``git clone https://github.com/[your_account]/Xamarin.Forms.GoogleMaps.git`` でローカルにクローンしたあと、 ``git config user.name yourname`` と ``git config user.email your@ema.il`` を設定してください。特に、``user.email`` は必ず GitHub のアカウントで使用している e-mail アドレスを設定してください。 - -## Making Changes - -* コードやドキュメントを XF.GoogleMaps に貢献するにはベースとなるブランチから、トピック・ブランチを作ってください。 - * 通常、これ(ベースとなるブランチ)は master ブランチです。 - * master ブランチから、トピック・ブランチを作るには: `git branch - issue_999 master` してから `git - checkout issue_999`で新しいブランチに切り替えます。master ブランチ上で作業するのを避けてください。 - 間違って、master ブランチ上で作業しないように、[pre-commit hook で master への commit を禁止した](http://blog.n-z.jp/blog/2014-02-07-pre-commit-hook.html) のような仕掛け - をいれるのも良いでしょう。 -* commit は合理的(ロジック単位)に分けてください。また目的と関係のないコードの変更は含めないでください(コードフォーマットの変更、不要コードの削除など)。 -* commit メッセージが正しいフォーマットにあることを確認してください。commit メッセージはできるだけ英語でお願いします。 - -```` -必須なコミット情報はここに(できるだけ英語で)。 - -上にある最初の列はパッチ/コミットの概要を説明します。 -この本文はパッチが無い状態のプログラムの行動、なんでこの行動は問題なのか、どうやってパッチが問題を解決するのかを説明します。 -```` - -* 変更の為にテストが必要ならそのテストが追加されているよう確認してください。 - -## Coding Style - -我々は [.NET Foundation](https://github.com/dotnet/corefx/blob/master/Documentation/coding-guidelines/coding-style.md) のコーディングスタイルを使用します。ただし、1点違いがあります。 - -> We use Allman style braces, where each brace begins on a new line. ~~A single line statement block can go without braces~~ - -我々は、**常に** 中括弧を使用します、1行の ``if/for/while/etc`` でも ``{ }`` を省略しないでください。 - -**例:** - -```csharp -// 👎🏽 DO NOT USE -if (source == null) - throw new ArgumentNullException("source"); - -// 👍🏽 GOOD -if (source == null) -{ - throw new ArgumentNullException("source"); -} -``` - -コード中には、コメントも含めて日本語は使わないでください。 - -## Submitting Changes - -* 自分の fork で、変更をトピック・ブランチに push してください。 -* XF.GoogleMaps のリポジトリに pull request を投稿してください。 - -pull request は、以下のように作成してください。 - -* タイトルは変更の要約を分かりやすく書いてください。 -* その変更が確認できるコードの場所を明記してください。通常これは [サンプルプログラム](https://github.com/amay077/Xamarin.Forms.GoogleMaps/tree/master/XFGoogleMapSample) に追加することを推奨します。 -* 本文には、関連する issue の番号を本文に含めてください。( ref #199 など) -* 本文には、その変更が確認できるコードの場所を明記してください。通常これは [サンプルプログラム](https://github.com/amay077/Xamarin.Forms.GoogleMaps/tree/master/XFGoogleMapSample) に追加することを推奨します。 -* まだ作業中である場合、タイトルの先頭に [WIP] を付けてください。マージ可能になったら、[WIP] を除去し、コメントでお知らせください。 - * 作業中に master ブランチが変更された場合は、コンフリクトを解消してから [WIP] を除去してください。 - * その作業を予約する意味で、まず [WIP] の付いた pull request を投稿することを許可します。ただし、長い間活動が見られない場合は、クローズされる場合があります。 - -# Thanks - -このドキュメントは、[MMP/CONTRIBUTING.md · sn0w75/MMP](https://github.com/sn0w75/MMP/blob/master/CONTRIBUTING.md) をベースに作成しました。 diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md deleted file mode 100644 index 8009ffa6..00000000 --- a/CONTRIBUTING.md +++ /dev/null @@ -1,79 +0,0 @@ -# How to contribute - -[日本語のコントリビューションガイドはこちら!](CONTRIBUTING-ja.md) - -Third-party contributions are essential for the future development of Xamarin.Forms.GoogleMaps. -We would like to keep it as easy as possible to contribute changes that get things working -on your environment. There are some guidelines that we need contributors to follow -so that we can keep on top of things. - -## Getting Started - -* Make sure you have a [GitHub account](https://github.com/signup/free). -* Create an Issue for your problem, assuming one does not already exist. - * Clearly describe the issue including steps to reproduce, stacktrace and environments when it is a bug. - * We have an [issue template](ISSUE_TEMPLATE.md), you can use some part of it. -* Fork the repository on GitHub. -* After cloning your repogitory to local, you should set ``git config user.name`` and `` git config user.email your@ema.il`` . Especially you **MUST** set ``user.email`` as same as your GitHub account's e-mail. - -## Making Changes - -* Create a topic branch from where you want to base your work. - * It would be usually from the master branch. - * To quickly create a topic branch based on master; `git branch - issue_999 master` then checkout the new branch with `git - checkout issue_999`. Please avoid working directly on the - `master` branch. -* Make commits of logical units. **Do not contain unrelated file changes(e.g. code formatting).** -* Check for unnecessary whitespace with `git diff --check` before committing. -* Make sure your commit messages are in the proper format. - -```` -Essential commit summary here. - -The body paragraph describes the behavior without the patch, -why this is a problem, and how the patch fixes the problem when applied. -```` - -* Make sure you have added the necessary tests for your changes. -* Run _all_ the tests to assure nothing else was accidentally broken. - -### Coding Style - -We follow the style used by the [.NET Foundation](https://github.com/dotnet/corefx/blob/master/Documentation/coding-guidelines/coding-style.md), with one primary exception: - -> We use Allman style braces, where each brace begins on a new line. ~~A single line statement block can go without braces~~ - -We **always** need braces, you can not go without braces. - -**Examples:** - -```csharp -// 👎🏽 DO NOT WRITE -if (source == null) - throw new ArgumentNullException("source"); - -// 👍🏽 GOOD -if (source == null) -{ - throw new ArgumentNullException("source"); -} -``` - -## Submitting Changes - -* Push your changes to a topic branch in your fork of the repository. -* Submit a pull request to the Xamarin.Forms.GoogleMaps repository. - -Make pull request guide line - -* Write a summary of the changes in easy-to-understand manner for the title. -* Show some usage or test code for your changes. We storongly recommend to add usage of new feature to the sample apps. -* Include related issue number for the contents. (e.g. ref #199) -* If your changes are work in progress, the title should start with [WIP]. If you worked out, delete the [WIP] and please let us know. - * If we changed the master before you completed the work, you should resolve conflicts. - * We accept your [WIP] pull request first, which means issue reservation. But if you became no longer active, we will close it. - -# Thanks - -This guide is based on [MMP/CONTRIBUTING.en.md · sn0w75/MMP](https://github.com/sn0w75/MMP/blob/master/CONTRIBUTING.en.md). diff --git a/README-ja.md b/README-ja.md deleted file mode 100644 index 492be357..00000000 --- a/README-ja.md +++ /dev/null @@ -1,218 +0,0 @@ -## ![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) [![Build status](https://build.appcenter.ms/v0.1/apps/99e6fb9e-fe8c-49df-b190-8aa1732a0ad2/branches/master/badge)](https://appcenter.ms) [![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|Yes (Bing map)| -|その他|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); - } -} -``` - -UWP の場合、 Xamarin.Forms.GoogleMaps.UWP.dll の Assembly を ``Xamarin.Forms.Forms.Init()`` に渡す必要があります。 - -```csharp -// App.xaml.cs -protected override void OnLaunched(LaunchActivatedEventArgs e) -{ - Frame rootFrame = Window.Current.Content as Frame; - - if (rootFrame == null) - { - rootFrame = new Frame(); - rootFrame.NavigationFailed += OnNavigationFailed; - - // Should add UWP side assembly to rendererAssemblies - var rendererAssemblies = new [] - { - typeof(Xamarin.Forms.GoogleMaps.UWP.MapRenderer).GetTypeInfo().Assembly - }; - Xamarin.Forms.Forms.Init(e, rendererAssemblies); - - Xamarin.FormsGoogleMaps.Init("your_bing_maps_api_key"); - - Window.Current.Content = rootFrame; - } - - if (rootFrame.Content == null) - { - rootFrame.Navigate(typeof(MainPage), e.Arguments); - } - Window.Current.Activate(); -} -``` - -既定の名前空間が ``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- -- |
-
- UPSPACE- -- |
-
- TransantiagoMaster- - |
-
- NowStation- -by 新陽社 - |
- - | -- | -