TerraMap API の使い方
TerraMap APIは、エリアマーケティングデータ（統計データ、ポリゴン、住所）を自社で用意せずに自社システムに組み込みたい方向けの地図システム開発支援Web APIです。
と言われてもどんなものか想像しにくいと思います。
何ができるの？使ったらいいことあるの？どうやって使うの？など、このページではリクエストやレスポンス例を紹介しながら、TerraMap APIの使い方をご紹介していきます。
TerraMap APIを使ってどんなことができるか、どんなメリットがあるかご理解いただければ幸いです。
TerraMap APIでは何ができるの？
ポスティングなどの地図を使った見積もり依頼システムを例にご紹介します。
地図を使った見積もり依頼システムでは、Google Mapなどの地図上に配布エリアのポリゴンを描画したり、配布数に応じた配布料金を表示したりする機能が求められる場合があります。
TerraMap APIを使用すると、指定範囲に含まれるポリゴンや住所、統計データなどを取得することができます。TerraMap APIから取得したポリゴンや住所などのデータは簡単に地図に表示することができます。また、取得したエリアの情報とお手持ちの配布数データなどを紐付けることで見積もり機能を実現することができます。
TerraMap APIを使うメリットは？
- 開発工数の削減
- TerraMap APIを利用すると、ポリゴンデータや統計データなどを自社で用意や整備する必要がなくなります。そのため、システム開発のコスト削減や開発期間の短縮を大幅に図ることができます。
- ポリゴン、統計データのメンテナンスが不要に
- 毎年の市区町村合併や新設、変更された住所にも対応しているため、ポリゴンや住所データ、統計データなど最新の状態でご利用いただけます。
TerraMap APIをご活用いただくことで、地図を使ったシステムが少ない手間で楽に構築することができます。
各種APIの利用例
お客様システムがWebアプリケーションの場合のイメージ図です。お客様システムのサーバーからTerraMap APIにリクエストしてご利用いただきます。
以下に各APIエンドポイントの利用例を示していきます。
※サンプルのため、以下のリクエスト例にあるTerraMap APIのドメインはダミーとなっております。
レイヤー一覧取得API
# リクエスト例 レイヤー一覧を取得 # URLはダミーです。 curl -H 'X-API-KEY:your_api_key' https://tmapi.example.jp/api/layers
# レスポンス例（一部抜粋）
{
"layers": [
{
"id": "00104",
"name": "町丁目",
"versions": [
"202001"
],
"type_id": "001",
"type_name": "行政界",
…
統計データ一覧取得API
# リクエスト例 統計データ一覧を取得 # URLはダミーです。 curl -H 'X-API-KEY:your_api_key' https://tmapi.example.jp/api/stats?layer_id=00104
# レスポンス例（一部抜粋）
{
"stats": [
{
"stat_id": "001011500",
"layer_id": "00104",
"layer_version": "202001",
"stat_name": "国勢調査2015その1",
"stat_items": [
{
"category_id": 5,
"item_id": 1,
"item_name": "人口総数15",
"item_unit": "人",
…
エリア取得API
地図上にポリゴンや住所などを表示させたい場合にご活用いただけます。ジオメトリ情報が含まれる場合はGeoJSON形式でレスポンスされるため、地図ライブラリに渡すだけでポリゴンが表示可能です。
# リクエスト例 エリア情報を取得
# URLはダミーです。
curl -X POST -H 'X-API-KEY:your_api_key' -H 'Content-Type: application/json' -d '{"layer_id": "00104", "area_type": "circle", "center_lat": 35.681236, "center_lng": 139.767125, "radius": [500], "output": "polygon,point"}' https://tmapi.example.jp/api/area
# レスポンス例（一部抜粋）
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "MultiPolygon",
"coordinates": [
[
[
[
139.76573633146,
35.6846769654978
],
[
139.766366290318,
35.6845469969259
],
…
各種言語、地図ライブラリを使ったサンプルコード
TerraMap API スタートアップガイド
各種プログラム言語でのリクエスト例やさまざまな地図ライブラリと連携する方法など、そのまま使えるサンプルコードと一緒に公開中です。
TerraMap APIをご検討中の方やこれから利用を開始される方におすすめのスタートアップガイドです。
