こんにちは、ジオテクノロジーズ株式会社カスタマーサクセス担当です。
日々、MapFan APIサポート窓口へ様々なご質問をいただく中で、「この点、もっと分かりやすくお伝えできていれば...」と気づかされることが多々あります。
そこで今回、2025年度上半期にいただいたご質問を振り返り、特にお問い合わせの多かったTOP3をまとめました。
少しでも皆様のお役に立ちましたら幸いです。
🚗 第2位：「道路通行量API、通行量はどうカウントされているの？」
Q.寄せられた声：
「時間帯をまたいで通行した場合、どうカウントされるんですか？」
「取得できる数値は延べ車両台数？それともユニーク数？」
「同じ車が何度も通ったら、その分カウントされる？」
「渋滞で停車していたら、ずっとカウントされ続けるの？」
渋滞予測や混雑回避ルートの提案などへ利用される道路通行量API。そのデータのカウント方法や数値の意味についてのご質問が第2位にランクインしました。こんな疑問をお持ちになった方も多いのではないでしょうか。
A.🤔 よくあるシチュエーション
たとえば、こんなケースを想像してみてください。
朝の通勤ラッシュ時：
ある配送トラックが午前8時55分に幹線道路に入り、渋滞に巻き込まれながら午前9時5分まで同じ道路を走行していた場合...
・6〜9時の時間帯にカウントされる？
・9～12時の時間帯にカウントされる？
・それとも両方？
さらに、同じトラックが午後にもう一度同じ道を通ったら、それも別々にカウントされるの？
システムを構築する際、このカウント方法を正しく理解するとよりご活用いただけるかもしれません。
📊 道路通行量APIの仕組み
実は、道路通行量APIで取得できる通行量データは、単純な「通過車両台数」ではありません。実際の通行量を反映できるよう、独自の推計手法を用いて算出されています。
まず押さえておきたい基本：
📅 時間単位は3時間ごと
表示される平均通行量（車）は「1日あたり」ではなく、3時間ごとの時間帯に対する平均通行量（車/時間）です。時間帯による通行量の変化を細かく把握できます。
👥 カウント方式は「延べ車両台数」
同じ車両が何度通っても、その都度カウントされます。つまり「ユニーク数」ではなく「延べ車両台数」としてカウント。配送業で同じルートを往復する場合、往路と復路がそれぞれカウントされるイメージです。
重要なポイント：
🚦 時間帯をまたぐ通行について
先ほどの例（8:55〜9:05に同一道路を通行）のような場合、実は両方の時間帯でカウントの対象となります。これにより、実際の通行量に近い状態を反映できるんです。
🅿️ 停車中のデータは除外
道路上で停車している場合（待ち合わせや荷物の積み下ろしなど）の位置情報は、推計データとして利用されません。あくまで「移動している車両」がカウント対象です。
🔄 同じ車両が再通過した場合
同じ日に、同じ車両が時間を空けて再度通過した場合（例：午前と午後）は、それぞれの時間帯で独立してカウントされます。延べ車両台数方式なので、実際の通行量として正しく反映されるわけですね。
⏱️ 細かいログの扱い
短時間に複数の位置情報が記録されていても、過剰に通行量が推計されることはありません。適切な処理により、実際の通行量に近い値が算出されます。
サポートチームより：
人のカウント方法も同様となっております。道路通行量APIの詳細な仕様については、技術仕様書に記載されています。
「この数値の意味を詳しく知りたい」など、ご不明な点があれば、いつでもサポートまでお問い合わせください。
🎯 まとめ：サポートチームは皆さんの味方です
今回ご紹介した内容は、実際に多くのお客様からいただいたご質問です。
「もしかして、こんなこと聞いていいのかな...」と思われたことがあったかもしれませんが、どんな小さな疑問でも、どうぞお気軽にお問い合わせください。
サポートチームは、皆さんがMapFan APIをスムーズにお使いいただけるよう、全力でサポートいたします。
MapFan APIサポートについて
MapFan APIの製品仕様に関するお問い合わせは、専用サポートサイトにてお問い合わせを承っております。
サポートサイトでは、仕様書のダウンロードやアップデート情報の確認、社内メンバーの問い合わせ履歴も含め、過去のやり取りをすべて確認できます。
URL：https://developers.mapfan.com/hc/ja
※アカウント登録が必要となります
※アカウント登録依頼や登録前にご質問の方はなんでも相談窓口へご連絡ください
※専用サポートサイトの詳細についてはこちら（https://geot.ent.box.com/file/1971741513251?s=zn6pxpm4697gdiag8injp8jwbgli78xy）よりご確認いただけます
他のランキング記事はこちら：
第1位：「PVのカウント方法が知りたい！」 – カスタマーサクセスサイト
第3位：「想像していたルート（距離）と結果が違う...なぜ？」、「登録メールアドレス、変更したいです」 – カスタマーサクセスサイト