Embed API 仕様

Embed API の仕様を紹介します。

Embed API とは

Geolonia の地図サービスでは、Embed API という API を提供しています。

この API は、Mapbox GL JS 互換の JavaScript API に加えて、簡単な HTML を記述するだけでユーザーの皆さんのウェブサイトに地図を埋め込むことも可能にしています。

このページでは、Embed API の詳しい仕様について紹介します。

はじめての方は、チュートリアルからはじめてみることをおすすめします。

Embed API の動作環境

  • Internet Exploerer 11 以降及びすべてのモダンブラウザの最新版。
  • Firefox などの一部のブラウザでは、WebGL に対する制限により、一つのページ内に16個を超える地図を設置することはできません。
  • API キー YOUR-API-KEY に限り、iframe 内での利用を許可しておりません。

ご利用中のブラウザが対応ブラウザかどうかは以下のページで確認することができます。 もし地図が表示されれば対応ブラウザです。

対応ブラウザかどうかを確認する

Embed API の設置

Embed API を利用するには、地図を設置したいページの </body> の直前に以下のコードを記述してください。

<script type="text/javascript" src="https://api.geolonia.com/v1/embed?geolonia-api-key=YOUR-API-KEY"></script>

YOUR-API-KEY の部分は、みなさんの API キーと置き換えてください。

HTML の記述

Embed API を利用して地図を設置するには、geolonia というクラス属性を持つ <div /> 要素を設置してください。この要素には、CSS 等で高さが指定されている必要があります。

<div class="geolonia"></div>

地図用の <div /> 要素の子要素は、マーカーをクリックした際に表示されるポップアップのコンテンツとして使用されます。

<div
  class="geolonia"
  data-lat="35.65810422222222"
  data-lng="139.74135747222223"
  data-zoom="9"
><strong>日本経緯度原点</strong><br>東京都港区麻布台二丁目</div>
日本経緯度原点
東京都港区麻布台二丁目

CodePen でサンプルコードを編集

属性の一覧

表示される地図をカスタマイズするための属性は以下のとおりです。

属性 内容 初期値
data-lat 表示する地図の緯度。例: 35.6581 0
data-lng 表示する地図の経度。例: 139.7413 0
data-zoom 表示する地図のズーム。0 から 24 までの数字を指定してください。 0
data-min-zoom 表示する地図の最小ズームレベル。 ``
data-max-zoom 表示する地図のズームレベル。 ``
data-bearing 地図の方角を 0 から 359 までの数字で指定してください。0 の場合、地図は北が上になり、180 の場合は南が上になります。 0
data-pitch 地図の傾斜角を 0 から 60 までの数字で指定してください。 0
data-hash 地図をマウス等で動かした際に、地図の座標やズームがページ URL のハッシュ値と連動させるかどうかを on または off で指定します。 off
data-marker data-lat および data-lng で指定した座標にマーカーを設置させるかどうかを on または off で指定します。 on
data-marker-color マーカーの色を #FF0000 または rgba(255, 0, 0, 0.5) の様に指定してください。 #E4402F
data-open-popup マーカーのポップアップがデフォルトで開いた状態で地図を表示させるかどうかを on または off で指定します。 off
data-custom-marker カスタムマーカーとして使用するための HTML 要素のセレクタを指定してください。例: #my-custom-marker  
data-custom-marker-offset カスタムマーカーの位置のオフセット値のピクセル数を数字で指定してください。例: 0, 25 0, 0
data-gesture-handling マウスホイールやタッチ操作によるページのスクロールの邪魔にならないように、alt キーまたは、2本指による操作を強制します。 on
data-navigation-control ナビゲーションコントロールを表示させるかどうかを on または off で指定します。 on
data-geolocate-control ジオロケーションコントロールを表示させるかどうかを on または off で指定します。 off
data-fullscreen-control フルスクリーンコントロールを表示させるかどうかを on または off で指定します。 off
data-scale-control 地図のスケールを表示させるかどうかを on または off で指定します。 off
data-geojson GeoJSON が記述されている要素のセレクタ、もしくは URL を指定します。参照  
data-cluster GeoJSON のクラスタ機能を有効化させるかどうかを on または off で指定します。参照 on
data-cluster-color クラスタ用のサークルの色を指定します。 #ff0000
data-style 地図のスタイルを指定します。参照 osm-bright
data-lang 地図の言語を auto または jaen のいずれかで指定します。 auto
data-loader 地図のローディング中のアニメーションを表示させるかどうかを on または off で指定します。 on
data-lazy 地図の地図の遅延ローディングを行うかどうかを on または off で指定します。 on

属性の使用例:

<div
  class="geolonia"
  data-lat="35.65810422222222"_
  data-lng="139.74135747222223"
  data-zoom="9"
><strong>日本経緯度原点</strong><br>東京都港区麻布台二丁目</div>

CodePen を使用するとサインアップ無しで Geolonia の地図をお試しいただけます。