Geekly Articles each Day

what3words APIの紹介：基本的な手順とサンプル



私たちの主なタスクは、地球上のあらゆる場所に住所を与えることでしたが、今日ではこのタスクが完了しました。 what3wordsの正方形のグリッドは地球全体をカバーし、各正方形には一意のアドレスがあります。 みんなに3ワードのアドレスを使用する機会を与え、それを便利にする時が来ました。 各地図、ナビゲーションアプリケーション、その他の位置情報サービスがwhat3wordsをサポートする場合に便利です。 このために、APIが作成されました。これについて詳しく説明します。

インターフェースをできる限りシンプルにし、開発者の時間と神経を節約するためにあらゆる努力をしました。 インターフェイスは、2つの基本的な手順を実行します。3ワードをロケーションに変換することと、ロケーションを3ワードに変換します。 3番目の追加手順は、3つの単語の使用可能な言語のリストを要求することです。 ほとんどの場合、APIとの通信はすべて単純なGETリクエストになります。 応答はJSONで提供されます。

1. 3つの単語を場所に変換します



この手順では、3つの単語を緯度/経度の座標のペアに変換します。 What3wordsアドレスは3 x 3メートルの正方形に与えられ、結果の座標はそのような正方形の中心の座標です。 座標と共に、応答には要求された3つの単語が含まれ、すべての修正が適用されます。

追加オプション

この手順では、追加の言語パラメーター（lang）が提供されます。使用すると、指定されたパラメーターに従って、返された3つの単語の言語が変更されます。 APIは送信された単語の言語を自動的に認識することができるため、リクエストで使用されている言語以外の言語で応答のアドレスを取得する場合にのみ、パラメータが役立ちます。

回答の正方形の角の座標を取得する場合は、対応する追加パラメーターを使用できます（corners = true）。 答えの正方形の中心の座標と一緒に、南東と北西の角の座標を受け取ります。

インターフェイスを構築するとき、要素の長さを知ることは役に立つかもしれません。 what3wordsの各単語の長さは3〜18文字で、陸上のオブジェクトを表す単語の大部分は4〜12文字です。 したがって、3ワードのアドレスの長さは、14（3x4文字+ 2ポイント）から38（3x12文字+ 2ポイント）文字です。

URL
 http://api.what3words.com/w3w

必須のGETパラメーター
鍵APIキー
ひもワード1.ワード2.ワード3

高度なGETオプション
lang追加の言語コード
コーナー「真」または「偽」

答え

  {
	 「タイプ」：「3ワード」、
	 「単語」：[「プロム」、「ケープ」、「ポンプ」]、
	 「位置」：[51.484463、-0.195405]、
	 「言語」：「en」
 }


コードサンプル

GETの例
  http://api.what3words.com/w3w?key=YOURAPIKEY&lang=en&string=index.home.raft


Php
  <？php

 $ ch = curl_init（ 'http://api.what3words.com/w3w'）;

 $フィールド=配列（
		 'key' => 'YOURAPIKEY'、
		 'string' => 'prom.cape.pump'
 ）;

 curl_setopt（$ ch、CURLOPT_POST、カウント（$フィールド））;
 curl_setopt（$ ch、CURLOPT_POSTFIELDS、http_build_query（$フィールド））;
 curl_setopt（$ ch、CURLOPT_HEADER、false）;
 curl_setopt（$ ch、CURLOPT_RETURNTRANSFER、true）;

 $ return = curl_exec（$ ch）;
 $ return = json_decode（$ return、true）;

 curl_close（$ ch）;


Linux Curl
  curl --data "key = YOURAPIKEY＆string = prom.cape.pump" http://api.what3words.com/w3w


JQuery
 データ= {
	 「キー」：「YOURAPIKEY」、
	 'string'： 'prom.cape.pump'
 };

 $ .post（ 'http://api.what3words.com/w3w'、データ、関数（応答）{
	 console.log（応答）;
 }）;



正規表現
  /^\p{Lasket+\.\p{L►+\.\p{L}+$/u


2.場所を3ワードに変換する



緯度/経度座標の各セットは、what3wordsグローバルグリッドの正方形のいずれかに該当し、それに対応する3ワードのアドレスを持っています。 同じ正方形内の場所を記述する座標は同じ住所を持ちます。 このプロシージャは、正方形の中心の座標と3ワードのアドレスを返します。

追加の言語パラメーター（lang）を使用して、3ワードのアドレスを受け取る言語を選択できます。 デフォルトでは、インターフェースは英語のアドレスを使用します。 パラメータ（corners = true）を使用して、正方形の角の座標を要求することもできます。 最初の手順と同様に、回答には、正方形の南西および北東の角の座標が含まれます。

URL
  http://api.what3words.com/position

GETオプション
キー（必須）APIキー
位置（必須）lat、lng（度）
lang追加の言語コード
コーナー「真」または「偽」

答え
  {
	 「単語」：[「プロム」、「ケープ」、「ポンプ」]、
	 「位置」：[51.484463、-0.195405]、
	 「言語」：「en」
 }

コードサンプル

GETの例
  http://api.what3words.com/position?key=YOURAPIKEY&lang=en&position=51.521251,-0.203586


Php
  <？php

 $ ch = curl_init（ 'http://api.what3words.com/position'）;

 $フィールド=配列（
		 'key' => 'YOURAPIKEY'、
		 '位置' => '51 .484463、-0.195405 '
 ）;

 curl_setopt（$ ch、CURLOPT_POST、カウント（$フィールド））;
 curl_setopt（$ ch、CURLOPT_POSTFIELDS、http_build_query（$フィールド））;
 curl_setopt（$ ch、CURLOPT_HEADER、false）;
 curl_setopt（$ ch、CURLOPT_RETURNTRANSFER、true）;

 $ return = curl_exec（$ ch）;
 $ return = json_decode（$ return、true）;

 curl_close（$ ch）;


Linux Curl
  curl --data "key = YOURAPIKEY＆position = 51.484463、-0.195405" http://api.what3words.com/position


JQuery
 データ= {
	 「キー」：「YOURAPIKEY」、
	 「位置」：「51 .484463、-0.195405」
 };

 $ .post（ 'http://api.what3words.com/position'、データ、関数（応答）{
	 console.log（応答）;
 }）;



3.利用可能なwhat3wordsアドレス言語のリストを取得する



URL
  http://api.what3words.com/get-languages

必須のGETパラメーター
鍵APIキー

答え
  {
	 「言語」：{
					 {「コード」：「en」、
					   「名前」：「英語」}、
					 {..}
	 }
 }

コードサンプル

GETの例
  http://api.what3words.com/get-languages?key=YOURAPIKEY&lang=en&position=51.521251,-0.203586

 http://api.what3words.com/get-langauges?key=YOURAPIKEY&lang=en&strong=index.home.raft


Php
  <？php

 $ ch = curl_init（ 'http://api.what3words.com/get-languages'）;

 $フィールド=配列（
		 'key' => 'YOURAPIKEY'
 ）;

 curl_setopt（$ ch、CURLOPT_POST、カウント（$フィールド））;
 curl_setopt（$ ch、CURLOPT_POSTFIELDS、http_build_query（$フィールド））;
 curl_setopt（$ ch、CURLOPT_HEADER、false）;
 curl_setopt（$ ch、CURLOPT_RETURNTRANSFER、true）;

 $ return = curl_exec（$ ch）;
 $ return = json_decode（$ return、true）;

 curl_close（$ ch）;


Linux Curl
  curl --data "key = YOURAPIKEY＆position = 51.484463、-0.195405" http://api.what3words.com/position


JQuery
 データ= {
	 「キー」：「YOURAPIKEY」、
	 「位置」：「51 .484463、-0.195405」
 };

 $ .post（ 'http://api.what3words.com/position'、データ、関数（応答）{
	 console.log（応答）;
 }）;



これで、APIに慣れることができます。 このリンクで登録します。APIキーを受け取るために登録していることを下部に示します。 後で、ライブラリ、SDK、および開発者向けのその他のツールについて詳しく説明します。

Source: https://habr.com/ru/post/J253319/

More articles:


All Articles