開発者ツール

Mapcodeで開発

Mapcodeを素早く試したい場合はREST APIから始めましょう：統合は簡単で、数分で結果を得ることができます。TypeScriptなどのライブラリは、ローカルまたはオフラインでのエンコーディング、低レイテンシ、ネットワーク依存のない環境、またはAPIデータ転送コストを削減したい場合に使用します。

REST API: はじめに REST API: 試してみる！

推奨順序

  1. 最も早い統合にはREST APIを使用。
  2. WebまたはNode.jsアプリでローカルエンコーディングが必要な場合はTypeScriptを使用。
  3. スクリプト、分析、バックエンドワークフローにはPythonを使用。
  4. 既存のJVMアプリケーションにはJavaを使用。

REST APIクイックスタート

パブリックREST APIを使用して、エンコードとデコードのフローを確認した後、より深い統合を選択します。これらの例では、アフリカの中立なランドマークであるMount Kilimanjaroを使用します。

1. 座標からmapcodeへ

Mount Kilimanjaro付近の座標のmapcodeをリクエストし、ローカル結果をタンザニアに制限します。

リクエスト 
GET https://api.mapcode.com/mapcode/json/codes/-3.0674,37.3556?territory=TZA
主要なレスポンス 
{
  "local": {
    "mapcode": "86.W6V5",
    "territory": "TZA"
  }
}

2. mapcodeから座標へ

ローカルmapcodeをデコードして、表現される領域の中心点に戻します。

リクエスト 
GET https://api.mapcode.com/mapcode/json/coords/TZA%2086.W6V5
主要なレスポンス 
{
  "latDeg": -3.0673755,
  "lonDeg": 37.3555635
}

デコード後の小さな座標の違いは正常です。mapcodeは正確な元の入力ポイントではなく、小さな領域を表すためです。

完全なREST APIドキュメントを開く

ライブラリ

ネットワーク呼び出しに依存せず、独自のアプリケーション内でMapcodeのエンコードとデコードを行いたい場合は、ライブラリを使用します。

TypeScript

Web、Node.js、TypeScriptプロジェクトに推奨されるライブラリです。

npm package GitHubのソース

インストール 
npm install mapcode-ts
エンコードとデコード 
import { encodeToShortest, decode, Territory } from "mapcode-ts";

const code = encodeToShortest(-3.0674, 37.3556, Territory.TZA);
console.log(code.getCodeWithTerritory()); // TZA 86.W6V5

const point = decode("TZA 86.W6V5");
console.log(point.getLatDeg(), point.getLonDeg());

Python

スクリプト、データワークフロー、バックエンドサービスにPythonを使用します。

PyPI package GitHubのソース

インストール 
pip install mapcode
エンコードとデコード 
import mapcode

print(mapcode.encode(-3.0674, 37.3556, "TZA")[0])
print(mapcode.decode("TZA 86.W6V5"))

Java

既存のJVMアプリケーションにMapcodeを統合する場合はJavaを使用します。

Mavenメタデータ GitHubのソース Javaドキュメント

Maven依存関係 
<dependency>
  <groupId>com.mapcode</groupId>
  <artifactId>mapcode</artifactId>
  <version>2.4.19</version>
</dependency>
エンコードとデコード 
import com.mapcode.Mapcode;
import com.mapcode.MapcodeCodec;
import com.mapcode.Point;
import com.mapcode.Territory;

Mapcode code = MapcodeCodec.encodeToShortest(-3.0674, 37.3556, Territory.TZA);
System.out.println(code.getCodeWithTerritory());

Point point = MapcodeCodec.decode("TZA 86.W6V5");
System.out.println(point.getLatDeg() + ", " + point.getLonDeg());

その他のツール

これらのツールは引き続き利用できますが、新しい技術的統合の多くはREST、TypeScript、Pythonから始めることをお勧めします。

コマンドラインユーティリティ

C/C++ ソースコードには、クロスプラットフォームのコマンドラインユーティリティが含まれており、mapcodeのエンコードとデコードが可能です。

MyMapcodes.com

簡単に mapcode を見つけるために MyMapcodes.com をご利用いただけます。MyMapcodes は、無料の非公式ウェブサイトです。

レガシーツール

レガシー Windows ツールは引き続き利便性のために提供されていますが、新しい統合には推奨されません。

位置 -33.93, 18.8 をエンコード: 
mapcode -e -33.93, 18.8
再度デコード: 
mapcode -d ZAF WK.QV5
mapcode を座標に変換: 
=WEBSERVICE("https://api.mapcode.com/mapcode/xml/coords/Q4.HGY?context=NLD")
座標を mapcode に戻す: 
=WEBSERVICE("https://api.mapcode.com/mapcode/xml/codes/52.460897,5.1074585")