位置情報ゲームを、もっと身近に。
RootMapは、モンスターやスポットなどのゲームオブジェクトを 現在地の周辺から取得するためのAPI基盤です。このガイドでは、 安全な認証から最初のレスポンスまでを順番に説明します。
{
"data": [
{
"id": "treasure_shibuya_01",
"kind": "treasure",
"name": "青い宝箱",
"location": {
"latitude": 35.6597,
"longitude": 139.7008
},
"distanceMeters": 34.21,
"properties": { "rarity": "rare" }
}
],
"meta": {
"resultCount": 1,
"usage": { "remaining": 99999 }
}
}QUICKSTART
秘密情報をゲームへ埋め込まず、短期tokenを渡すのが基本です。
https://api.rootmapgeo.com を ROOTMAP_BASE_URL に設定してください。 管理画面で作成したテスト用credentialだけを使用し、本番データは送らないでください。
rmk.<id>.<secret> 形式のproject credentialは、 ゲーム開発者のバックエンドだけで安全に保管します。
個人情報ではないplayerIdを送り、15分間だけ使えるtokenを受け取ります。
player tokenをAuthorizationヘッダーへ入れて、現在地と半径を送ります。
curl --request POST "$ROOTMAP_BASE_URL/v1/player-sessions" \
--header "Authorization: Bearer $ROOTMAP_PROJECT_CREDENTIAL" \
--header "Content-Type: application/json" \
--data '{"playerId":"player_01HXYZ"}'curl --get "$ROOTMAP_BASE_URL/v1/objects/nearby" \
--header "Authorization: Bearer $PLAYER_TOKEN" \
--data-urlencode "lat=35.6595" \
--data-urlencode "lng=139.7005" \
--data-urlencode "radius=500" \
--data-urlencode "limit=20"AUTHENTICATION
配布済みアプリから秘密情報を回収するのは困難です。交換処理はバックエンドで行います。
playerIdにはメールアドレスや氏名ではなく、推測しにくい仮名IDを使います。
API REFERENCE
すべてのレスポンスはJSONです。成功・失敗を問わずキャッシュしません。
/v1/player-sessionsproject credentialを15分間のplayer tokenへ交換します。
| Authorization | Bearer project credential |
|---|---|
| Content-Type | application/json |
| playerId | 3–128文字の仮名ID |
| 最大本文 | 4 KiB |
{
"tokenType": "Bearer",
"accessToken": "eyJhbGciOi...",
"expiresIn": 900,
"expiresAt": "2026-08-05T12:15:00.000Z",
"scope": "objects:read"
}/v1/objects/nearby指定した座標を中心に、距離が近いゲームオブジェクトを返します。
| 名前 | 必須 | 範囲 | 説明 |
|---|---|---|---|
lat | はい | -90〜90 | 緯度 |
lng | はい | -180〜180 | 経度 |
radius | いいえ | 1〜1,000 m | 検索半径。初期値500 |
limit | いいえ | 1〜100 | 最大件数。初期値50 |
curl --get "$ROOTMAP_BASE_URL/v1/objects/nearby" \
--header "Authorization: Bearer $PLAYER_TOKEN" \
--data-urlencode "lat=35.6595" \
--data-urlencode "lng=139.7005" \
--data-urlencode "radius=500" \
--data-urlencode "limit=20"/health認証なしでAPIの稼働状態と版を確認します。
LIMITS & USAGE
短時間の連打と月間利用量を別々に管理し、429レスポンスで安全に停止します。
playerごと・60秒ごとのnearby検索。超過時は60秒後に再試行します。
Free検証枠の初期値。レスポンスのusageで残数と更新日時を確認できます。
公開予定価格をStripeテスト環境で確認できます。実際の請求は発生しません。
※ Rate Limitは悪用防止用です。月間利用量はRootMap側のproject counterを基準にします。
PRICING
現在はpublic betaです。有料プランはStripeテスト環境でのみ選択でき、本番請求は行いません。
月10万 API操作
個人開発・動作検証月200万 API操作
小規模な商用ゲーム月2,000万 API操作
スタジオ・受託開発月1億 API操作
複数案件・イベント専用構成・SLA・導入支援
要件に合わせた個別見積もり※ 上記はpublic betaの公開予定価格です。消費税、超過料金、解約・返金条件は有料提供開始前に最終表示します。
ERRORS
エラー本文にはcodeとmessageが含まれます。予期しない問題ではrequestIdも返します。
| HTTP | code | 対応 |
|---|---|---|
| 400 | invalid_query | 座標、半径、件数などの入力を確認してください。 |
| 401 | invalid_credential | プロジェクト認証情報が不正または失効しています。 |
| 401 | invalid_token | player tokenを再発行してください。 |
| 403 | project_inactive | プロジェクトの状態を管理画面で確認してください。 |
| 403 | insufficient_scope | 必要な権限を持つtokenを使用してください。 |
| 413 | payload_too_large | リクエスト本文を4 KiB以下にしてください。 |
| 415 | unsupported_media_type | Content-Typeをapplication/jsonにしてください。 |
| 422 | candidate_limit_exceeded | 検索半径を狭めるか、データを分割してください。 |
| 429 | rate_limited | 60秒待ってから再試行してください。 |
| 429 | quota_exceeded | 月間枠の更新を待つか、プランを見直してください。 |
OPERATIONS
公開stagingは稼働中です。healthを確認できます。本番環境とSLAはまだ提供していません。
2026-08-06：public beta、料金案、東京ベースマップ、問い合わせ窓口を公開。
playerIdは仮名化してください。地図公開時はOpenStreetMapの帰属表示が必要です。
PUBLIC BETA POLICY
有料提供前の検証版として、保存する情報と問い合わせ先を明確にします。
ログイン識別子とメールアドレス、プロジェクト設定、復元できない形式の接続キー、配置データ、API利用量、Stripeの顧客・契約識別子を運用に必要な範囲で保存します。
周辺検索の緯度・経度は応答処理に使い、通常ログへ記録しません。playerIdには氏名やメールアドレスではなく仮名IDを使用してください。
SLAはありません。実データや機密情報を送らず、障害・仕様変更・データ初期化があり得る検証環境として利用してください。Stripe画面はテスト環境で、請求は発生しません。
support@rootmapgeo.com、個人情報は privacy@rootmapgeo.com、脆弱性は security@rootmapgeo.com へ連絡してください。
販売主体の正式情報、特定商取引法表示、税込価格、解約・返金条件を確定・掲載し、live決済を別環境で検証してから有料提供へ切り替えます。