地図の上に作る。

埋め込んだ地図を動かす

クライアントを読み込んで地図を置くと、あなたのページから日付や場所へ動かし、任意の共有リンクを表示させ、読者が地図をどこへ動かしたかを受け取れます。

<div id="map"></div>
<button id="to-1939" type="button">1 September 1939</button>
<script type="module">
  import { mount } from 'https://rwmqx7dwb5-arch.github.io/IntMap/js/embed-client.js';
  const map = mount('#map', { hash: '#v=22.0000,48.5000,3.30,0,0,f&tt=1914-06-27', height: 450 });
  await map.ready;
  document.querySelector('#to-1939').onclick = () => map.setTime('1939-09-01');
  map.on('state', (s) => console.log(s.state.view, s.state.time, s.link));
</script>

あなたのページが送れるもの

地図があなたのページに伝えるもの

クライアントは便利のためのものです。中身は素の postMessage なので、ページから直接話すこともできます。

const frame = document.querySelector('iframe');
const origin = new URL(frame.src).origin;
frame.contentWindow.postMessage(
  { protocol: 'intmap-embed', v: 1, type: 'view', id: '1', lng: 139.69, lat: 35.69, zoom: 9 },
  origin);
window.addEventListener('message', (e) => {
  if (e.source !== frame.contentWindow || e.origin !== origin) return;   // only the map you framed
  if (e.data && e.data.protocol === 'intmap-embed' && e.data.type === 'reply') console.log(e.data.ok, e.data.hash);
});

命令が変えられるのは枠の中に何を映すかだけで、共有リンクにできることと同じです。枠が伝えるのは地図の状態（枠自身の「IntMap で開く」と同じリンク）だけで、読者についての情報は含まず、送り先は枠を置いたページだけです。

オープンデータ

地図が描いているデータセットを、ダウンロードできるファイルとして。キーは不要で、ウェブのホストの制限のほかに回数制限はありません。下のアドレスはどれも JSON ファイルです。

• api/v1/catalog.json

  再利用できるデータセットの全部——ファイル・大きさ・出典が述べるとおりのライセンス・そのライセンスが求めること・表示する出典——と、出していないデータセットとその理由。

• api/v1/countries.json

  国の一覧（Natural Earth のコード、英語と日本語の名前）と、それぞれの国について何かを述べているデータセット。

• api/v1/countries/JPN.json

  1 か国ぶん。国ごとのデータセットがその国について持つ行を全部、それぞれのデータセットの条件つきで。

• api/v1/embed.json

  埋め込みのアドレスと、上のメッセージの約束事を、データとして。

const catalog = await fetch('https://rwmqx7dwb5-arch.github.io/IntMap/api/v1/catalog.json').then((r) => r.json());
const japan = await fetch('https://rwmqx7dwb5-arch.github.io/IntMap/api/v1/countries/JPN.json').then((r) => r.json());
for (const d of catalog.datasets) if (d.terms.credit) console.log(d.id, d.credit.join(' · '));

データセットを出すのは、元になっている出典のすべてが再配布を許すライセンスを述べているときだけです。何も述べていないもの、再配布を許すと確認できない条件を述べているものは、黙って出さずに「出していないもの」として理由とともに載せます。複数の出典を合わせたデータセットには、いちばん厳しい条件がファイル全体にかかります。

ある日の国境を、形ごとに

地図で時計を日付に合わせ、「共有」の「引用」タブを開くと、その日に描かれている国境を GeoJSON で保存できます（全世界か、表示範囲）。形ごとに、記録と行・日付とそれを誰が述べたか・識別子・ライセンスが入り、ライセンスは上のカタログから行ごとに読みます。非営利に限られた条件の形は含めずにファイルに名前を書き、そうした記録で輪郭を切られた形は、輪郭なしで記録だけを入れます。

このビルドのサイトが出しているデータセット

再利用できるデータセット 48 件 · 出していないもの 50 件

出していないもの

再利用するときに守ること