Turf.jsを使うよ！　～距離とか面積とかを取得～

# Turf.jsとは？

　高機能なJavaScriptのWeb地図用GIS演算ライブラリです。
　シンプルで早くて、小さくモジュール化しているから、必要な物だけを取得して使えるよ、ということのようです。

https://turfjs.org/

　とにかく山のように命令があってなんかすごそう！　とは思いつつ、ご説明は全部英語だし、グーグル翻訳さんに訳してもらったところで、ワタシなどには何するもんだかサッパリな命令も多々あるわけなんですが、とりあえず欲しい機能だけをちょこっと使わせてもらう分には、さして難しいことでも無い様子。

# まずは準備です

## スクリプトを取り込む
　なでしこ３も、PC版はNode.jsで動いているというのに何ですが、ワタクシいまだによく分からない人なので、とにかく直でHTMLへscriptタグで読み込みたい。
　コレです！

```html
<script src='https://unpkg.com/@turf/turf@6.3.0/turf.min.js'></script>
```

　簡単ですね♪

　しかし、とりあえずお試しするには良いのですが、フルビルドしたものはサイズがべらぼうなので、カスタムビルドで必要なビットのみを取得せよと書いてある・・・ラシイ。
　結局それかよ、えぬぴーえむかよ、というところですが、とりあえず[**ここ**](https://turfjs-builder.herokuapp.com/)で、ポチポチと超簡単に作ることが出来ました。神だね！

## helpersの罠
　Turf.jsではなんでもGeoJSONってデータ形式にしなきゃなようで、なんかこんなの。

```json
{
  "type": "Feature",
  "properties": {},
  "geometry": {
    "type": "Point",
    "coordinates": [
      140.75497578224517,
      41.7946708822908
    ]
  }
}
```

　むむむ・・・（＠＿＠）
　それをやってくれるのが、helpersの中の一連の命令なんですよね。
　緯度経度やその配列を与えただけで、pointやらlineStringやらpolygonやらの形式のGeoJSONにしてくれるって寸法です。だから、大体使います。
　ご本家のExampleでは、こんな風になっております。

```Javascript
var point = turf.point([-75.343, 39.984]);
```

　これで、ちゃんと動いたんですよ。当初、

```html
<script src='https://unpkg.com/@turf/turf@6.3.0/turf.min.js'></script>
```

　を取り込んでた段階では。
　ところが、その後、ご入り用のmoduleだけでアレしようとしたら、途端にエラーになっちゃう。
　だから、てっきり、びるど？　がうまくいっておらぬのじゃろう・・・と思ってしまったせいで、大分ハマりました(´Д⊂ヽ
　こうでした。

```Javascript
var point = turf.helpers.point([-75.343, 39.984]);
```

# 距離を測りたい！
　さて、気を取り直して・・・まず第一にやりたいことは、距離を測ることなんですよね～。
　例えば、時代小説中の人物が歩いた道程を辿ってみるとかね☆
　それが、実際のところ何ｋｍくらいなんですかね？　的な。
　うーむと切絵図を眺めて、それからおもむろにぐーぐるまっぷと首っ引きで距離を測定してみたりする。それが、**Maplat + Turf.js**でなら、同一画面上で出来ちゃいそうじゃないですか？　楽しげ♪
　距離の測れそうな命令には、[turf.distance](https://turfjs.org/docs/#distance)と[turf.length](https://turfjs.org/docs/#length)がありました。

　コロナのせいですっかり馴染み深い単語になっちゃいましたね、`distance`。
　これは、二つの`point`を与えて、その間の距離を得る物。

　一方`length`は、`lineString`を与えてその長さを得る物。

　一応両方試しました。
　なでしこ３は、なでしこのプログラム中に、直でJavascriptを書いて実行することも出来ますよ！
　こんなふうに文字列としてJavascriptの関数を書き、それに引数を与えて`JS関数実行`できます。
　関数の中身は、ご本家のExampleのとうり。

- **turf.distance**

```Javascript:distance
『(function(from,to){
  var from = turf.helpers.point(from);
  var to = turf.helpers.point(to);
  var options = {units: 'meters'};
  return turf.distance(from, to, options);})』をdistanceに代入。

distanceを[[140.76033681119014,41.79635583006893],[140.75360256611546,41.79599719142311]]でJS関数実行して言う。# 559.6794099196878
```

- **turf.length**

```Javascript:length
『(function(line){
  var line = turf.lineString(line);
  return turf.length(line, {units: 'meters'});})』をlengthに代入。

lengthを[[[140.76033681119014,41.79635583006893],[140.75360256611546,41.79599719142311]]]でJS関数実行して言う。# 559.6794099196878
```

　結果は、バッチリ一緒でした～☆（そりゃそうか）
　そして試しに、ぐーぐるまっぷの「距離を測定」で、ざっくり測ってみたら、ちゃんと大体一致しました～♪
　いや、べべべつにTurf.jsを信じてなかった訳じゃ無いんですがっ！

　それはさておき、`distance`も`length`も結果が合うなら・・・圧倒的に`length`の方が便利ですよね～。
　`length`は、lnglatsの配列を`lineString`にして与えれば、二点間はもとより、どんなにぐねぐね曲がりくねろうと、一発で距離を出してくれますが、`distance`は、ぐねぐねしていた場合には、lnglatsの配列を反復して、順々足していかなきゃいけませんからね。
　こんな感じ？

- **turf.distance**

```Javascript:distance
道程＝[[140.76033681119014,41.79635583006893],[140.758478619304,41.79556157762579],[140.75721413722778,41.79432302386439],[140.75619270341997,41.79496643842464],[140.75497595771563,41.79462275418183],[140.75484194014732,41.79560505340086],[140.75360256611546,41.79599719142311]]

A=0。
((道程の要素数)-1)回
　A＝A＋(distanceを[道程[回数-1],道程[回数]]でJS関数実行）。
ここまで。

Aを言う。# 790.762102688524
```

　やっと、なでしこで書いてる甲斐が出てきたｗ

- **turf.length**

```Javascript:length
lengthを[道程]でJS関数実行して言う。# 790.762102688524
```

　一発☆

　当然ですけど、こちらもピッタリ一致。
　Turf.js的には、与える引数が点か線かとゆう違いがあるんでしょうが、ワタシなどがなでしこのプラグインにして、ラクに使ってやろうというにあたっては、どっちみち引数は緯度経度にしちゃいますから、一緒ですｗ

# ついでに面積
　面積も、[turf.area](https://turfjs.org/docs/#area)でlnglatsの配列を`polygon`にして与えたら、複雑な形でもしゅっと出してくれます。

```Javascript:area
『(function(lnglats){
  var polygon = turf.helpers.polygon(lnglats);
  return  turf.area(polygon);})』をareaに代入。

道程に道程[0]を配列追加。
areaを[[道程]]でJS関数実行して言う。
```

　でも、四角になるように経緯度を調整して、`distance`で二辺の距離を出して計算してみたのとは、ビミョーに合わなかった。
　地球は平面じゃないから、おそらく深遠な計算式があるのであろう。小学校でやるような面積の出し方ではないのだ。
　いや・・・平面ってコトでいいじゃん！　って言うような、狭い範囲内なんだけどなあ・・・ｗ
　いずれにせよ、古地図上のことなので、ベツにざっくりとで良いんですが。

　注意点としては、polygonの時はパス（？）が閉じてないとダメです。（lnglatsの最初と最後を同じにする）
　lineStringの配列なので、同じ範囲でも、lengthで外周の長さを測ってやろうという場合より、一段階層が深くなります。
　距離の時には、単位を指定出来るオプションがあったけど、これは平方メートル限定らしい。

# 中心とか重心とか
　[turf.center](https://turfjs.org/docs/#center)とか[turf.centroid](https://turfjs.org/docs/#centroid)とか、一応やってみたけど、意味はだいたいわかるけども、私にとって使い途があるかどうかは不明ｗ
　しかも、turf.centroidと[turf.centerOfMass](https://turfjs.org/docs/#centerOfMass)の違いが分からんorz。何か、異なる計算式によって算出されているのであろう。

# 動作確認
　プラグインにして、とりあえずここまでをMaplat上に反映してみました～。

> https://snowdrops89.github.io/Maplat_test/test/nako3_test_Turf_1.html

　これで、なでしこらしく`p1からp2までの距離取得`とか、`lineの道程取得`とかで、距離を得られるようになりました♪
　・・・結局distanceも残したので、lengthは長さって言うのもアレだし「道程取得」にしてみたんだけど、どうだろう？　英語力だけじゃなく、日本語力も問われるのか・・・
　なでしこ開発者様のご苦労が忍ばれるね！

　プラグインはココ。

> https://github.com/snowdrops89/nako3_plugin_Maplat

　Maplatで使いたいことだけを、ちょこちょこと入れるだけのつもりなので、Maplatと同居。
　しかし、やはり、Maplatのプラグインとはファイルを分けました。
　それぞれのscriptの取り込みが必要ですからね。
　
# つづきます
　なんか、肝心のトコまで行き着きませんでしたけど；；；
　もう、使う物は既にプラグインにはしてあるし、別に引っ張るようなアレでも無いんですが、例によって出来たの出来ないのと騒いでいるうち結構な文字数になったので、続きとします。（まだちゃんとしたサンプル作ってお試ししてないし、もう文章書くの疲れたし＞＜；）
　次こそは地図上にバス？を走らせたり、進行方向に従って地図の向きを変えたりしてみます！

> [Maplat Coreで古地図の上にバスを走らせてみる](https://qiita.com/kochizufan/items/26d7e3287c5d1402eff5)
> [Maplat Coreで古地図の上に明滅するバスを走らせてみる](https://qiita.com/kochizufan/items/5303898ecbb6f089eccf)
> [Maplat Coreで古地図上を進行方向に視点を変えながら走り回ってみる](https://qiita.com/kochizufan/items/84e36400e6d7a00e31eb)