開発者向けのツールとダウンロードコンテンツ
このセクションでは、Mapcodeに関連するツールをご覧いただけます。Mapcodeシステムの技術的な詳細やソースコードに興味がある場合は、開発者向けセクションに以下の内容が含まれています:
- 参考資料
- ウェブサービス (REST API)
- ソースコード
参考資料
以下の参考資料をダウンロードできます:
REST API
Mapcode Foundationは、座標とMapcodeの間の変換を行い、領域およびアルファベットの参照データを提供する無料のパブリックREST APIを運営しています。これはデモンストレーション目的で利用可能です。本番環境での使用には、オープンソースのサーバーを自己ホスティングできます。
iOSおよびAndroidアプリ
AndroidおよびiOSのモバイルフォンでは、Mapcode Finderアプリをご利用いただけます:
- Mapcode Finder for Android - Google Playストアにて (※"Google PlayStore"は日本語表記では「Google Playストア」が一般的なため調整)
- Mapcode Finder for iOS(Apple AppStoreにて)
これらのアプリは無料です。オンラインのMapcode REST APIを利用しています。これらのアプリは位置情報データを当社のサーバーに送信しますので、データの取り扱いについて詳しく知りたい場合は、当社のプライバシーポリシーをご覧ください。(簡単に言うと:当社はサービスの向上にのみ利用し、第三者に販売またはアクセス権を付与することはありません。)
macOS、Windows、Linux
MacOS、Windows、およびLinux向けに、Mapcode Utilityというツールを提供しています。このツールを使用すると、コマンドラインインターフェースでMapcodeのエンコードとデコードが可能です。
例えば、次のコマンドを使用して、位置 33.93, 18.8 をエンコードします:
mapcode -e -33.93, 18.8 そして、これを再度デコードするには次のコマンドを使用します:
mapcode -d ZAF WK.QV5 このユーティリティには、さらに多くのオプションがあります。「mapcode」をパラメーターなしで実行すると、ヘルプテキストが表示されます。
Maven依存関係
MavenプロジェクトでMapcode Javaライブラリを使用するには、Mavenのpom.xmlファイルに以下の依存関係を追加してください:
<dependency>
<groupId>com.mapcode</groupId>
<artifactId>mapcode</artifactId>
<version>2.4.14</version>
</dependency> ソースコード、サンプルコード、およびドキュメントは、Javaソースコードページでご覧いただけます。
位置情報をMapcodeに変換(およびその逆)
当社のC/C++ Mapcodeライブラリのユーティリティディレクトリにある「mapcode」というクロスプラットフォームのコンソールツールを提供しています。ご希望のOSでご利用いただけます。ユーティリティはこちらからご覧いただけます:
このユーティリティは、お使いのプラットフォームでご自身でコンパイルする必要があります。
スプレッドシートを使用してMapcodeを変換
コンソールツールを使用して位置情報とMapcodeを相互変換する代わりに、Excel(Windows)またはGoogle Docsを使用して、無料のMapcode変換ウェブサービスを直接呼び出すこともできます。
例えば、Mapcodeを位置情報に変換するには、セルにこの数式を入力します:
=WEBSERVICE("https://api.mapcode.com/mapcode/xml/coords/Q4.HGY?context=NLD") これはMapcodeを緯度経度52.460897, 5.1074585に変換します。この位置情報をMapcodeに戻すには、以下を入力してください:
=WEBSERVICE("https://api.mapcode.com/mapcode/xml/codes/52.460897,5.1074585") ここからサンプルのスプレッドシートをご覧いただけます:
Google Docsでは、ウェブサービスと連携するための同様の数式を提供しています。ウェブサービスの使い方に関する簡単なマニュアルは、こちらをクリックしてください。
マイマップコード.com
MyMapcodes.com を使用すると、パソコンだけでなくスマートフォンでも簡単にMapcodeを検索できます。MyMapcodes は無料の関連のないウェブサイトです。
レガシーツール
ご利便のため、レガシーWindowsツールも提供していますが、これらは将来的に廃止される可能性があります。コンソールツールのmapcoder.exeを使用すると、座標をMapcodeに、またはその逆へと素早く変換できます。一度にスプレッドシートやデータベース全体を処理することも可能です。完全なドキュメントが含まれています。
レガシー対応のため、旧バージョンのコンソールツール(バージョン1.50.1)をご用意しております。これは、2.0以前のMapcodeをデコードする必要がある場合にご利用いただけます。ただし、2.0以前のMapcodeの使用はお勧めしません。