ゴルフ場のコース管理の担当がグリーンとフェアウェイの写真を Gemini で見て、芝の病気・乾き・傷みの候補と手当ての記録の下書きを作る

処理の起点を決める

フォームの送信で動きます。 Google Apps Script のインストール型のトリガーには、フォームの送信で動く種類があります。担当がホールと地点を選んで写真を上げた時点で、その地点の分だけを処理します。 巡回の全部が終わるのを待たないので、グリーンキーパーは巡回の途中から、先に回ったホールの候補を見られます。

インストール型のトリガーは、作った人のアカウントで動きます。 担当それぞれのアカウントで作るのではなく、コース管理の部門の共用のアカウントで1つだけ作ります。 作った人が異動すると止まるので、作り直しの手順を日誌のシートに書いておきます。

台風や大雨の後の臨時の巡回も、同じフォームで上げます。 フォームに「臨時」の選択肢を置き、臨時の写真は前回の定時の写真と組にします。 臨時の写真どうしを比べると、雨の前の状態が分かりません。

入力データを集める

質を決めるのは、毎回同じ地点から同じ向きで撮ることです。 グリーンの奥から手前を見た写真と、手前から奥を見た写真では、同じ変色でも広さが違って見え、変化が比べられません。 地点ごとに、スプリンクラーの頭やヤーデージの杭など、写真に入れる目印を決めます。

撮った条件は、乾きと露の見分けに使います。 朝露が残っている芝は色が濃く見え、露の無い場所は乾いて見えます。露の有無を指示に入れておくと、露の跡を「乾き」と言いにくくなります。

芝の種類も渡します。 グリーンのベントグラスとフェアウェイのコウライシバでは、季節ごとの色の変わり方が違います。冬の休眠で色が抜けたコウライシバを「変色」と言わせないためです。

データの取得方法を決める

フォームの回答から、ホール・地点・写真のファイルを取ります。 スクリプトは回答の行からファイルの場所を読み、ドライブから写真を取ります。前回の写真は、同じホールと地点の、今回より前で最も新しい回答から探します。

Gemini API へは、地点ごとに1回、前回と今回の2枚を組にして渡します。 1日の巡回で地点の数だけ呼びます。地点ごとに分けると、撮り直しのときにその地点だけを比べ直せます。

手当ての記録は、スクリプトがAIの結果とは別の欄に用意します。 日誌の行には、候補の欄、担当が選ぶ手当ての欄（散水、目土、補修、カップの移動、立入の制限、様子を見る）、グリーンキーパーの見立ての欄があります。手当ての欄をAIに埋めさせない作りにします。

有料の利用枠で使い、store を false にします。 Gemini API の規約では、有料のサービスではプロンプトと応答が製品の改善に使われないとされています。Interactions API は既定でやり取りを保存し（有料の枠で55日）、保存しないときは store=false を付けると案内されています。

AIへ渡す前に整形する

1. 形式と向き … スマートフォンの写真の向きの情報で回転しているだけのものは、画素を回転させます。向きがずれると、返った枠がずれます
2. 縮小 … 長い辺を1,600ピクセル程度に縮めます。ボールマークのような小さい傷みは、寄りの写真で撮る決まりにします
3. 組の確認 … 前回の写真が無い地点は「前回の写真なし」とし、今回の写真だけで候補を拾わせます
4. 撮った条件の付け足し … 前回と今回の天気、朝露の有無、日の向きを指示に入れます
5. 地点と芝の種類の付け足し … 何を撮る地点か、芝の種類、今の季節を指示に入れます
6. 人の写り込みの確認 … 来場者や作業の人が大きく写っている写真は、担当が撮り直します

4番目を軽く見ないでください。 前回が露の残る朝、今回が露の無い朝なら、グリーンの色は写真の上で大きく変わります。 その差を前提に比べさせないと、グリーン全体が「乾きが進んだ」と返ってきます。

AIに処理させる

させるのは、地点ごとに前回と今回の写真を比べ、今回の写真の候補を枠か輪郭で返し、前回からの変化と、写っていない範囲を返すことだけです。

右端の列の考え方は、迷ったらグリーンキーパーに見せる側に倒すことです。 変色か露か分からないものは候補に入れます。候補が多いのは担当の数秒で済みますが、候補から落ちた病気の始まりは、翌日には広がっているかもしれません。

1行目と2行目がいちばん起きやすい失敗です。 輪状の変色の写真を渡すと、AIは病名を挙げ、効く薬剤まで書きたがります。日誌の下書きにその言葉が載ると、担当がそれを見て散布の準備を始めてしまいます。 返すのは「輪状の茶色の変色」という写っている事実までにします。

農薬を書かせない理由は、記録の決まりにもあります。 農薬を使用する者が遵守すべき基準を定める省令は、ゴルフ場で農薬を使う者に、毎年度、使用の最初の日までに農薬使用計画書を農林水産大臣と環境大臣に出すことと、ゴルフ場の外に農薬が流出しないよう必要な措置を講じるよう努めることを求めています。農薬を使ったときは、使用した年月日、場所、対象、農薬の種類または名称、単位面積当たりの使用量または希釈倍数を帳簿に記載するよう努めることも定めています。散布の記録は、人が実際に使ったものを書く記録で、AIの下書きから写すものではありません。

指示内容を固定する

あなたはゴルフ場のコース管理の日誌づくりを手伝う係です。
同じホールの同じ地点を撮った2枚の写真があります。
1枚目は前回の巡回、2枚目は今回の巡回で撮ったものです。

【この地点】{ホール}番 {地点の番号}：{グリーンの奥から手前／カラー／フェアウェイの着弾の地点}
【芝の種類】{ベントグラス／コウライシバ ...}　【季節】{夏}
【撮った条件】前回：{天気、朝露の有無、日の向き}　今回：{天気、朝露の有無、日の向き}

【やること】
1. 2枚目の写真で、次の候補を探す。
   病気の兆候のような変色、乾き、ボールマーク、ディボット跡、擦り切れ、
   機械の跡、雑草、動物の掘り返し。
2. 候補ごとに、2枚目の写真の上の枠を [ymin, xmin, ymax, xmax] の順で、
   0〜1000 に正規化して返す。広がりのある候補は輪郭も返す。
   色、形（輪状・斑点・不定形・筋）、おおよその広さを書く。
3. 候補ごとに、1枚目と比べて new／progressed／unchanged／improved を付ける。
   1枚目で同じ場所が見えなければ not_comparable とする。
4. 影、逆光、朝露の照り返し、旗竿やカートで見えない範囲を返す。

【厳守事項】
- 病名を書かないでください。「病気の兆候のような変色」までにしてください。
- 薬剤、散布の量、散水の量、刈り込みの高さを書かないでください。
- 朝露の有無や日の向きの違いによる色の違いを、変化として扱わないでください。
- 季節による芝の色の変わり方（休眠など）を、変色として扱わないでください。
- 変色か露か影か分からないものは、kind を unclear にして候補に入れてください。
- 見えない範囲について「異常なし」と書かないでください。
- 写っている人については何も書かないでください。

「病名を書かない」を最初に置くのは、表現の問題ではありません。 病名が日誌に載ると、グリーンキーパーが見る前に、担当の頭の中で手当てが決まってしまいます。 判断の入口を、写っている事実の側に固定しておきます。

出力形式を固定する

地点ごとに、次の形の JSON で受け取ります。 kind、shape、change、reason は enum で決まった文字列に絞ります。

{
  "hole": 7,
  "point_id": "G-N",
  "candidates": [
    { "box_2d": [380, 420, 520, 590],
      "kind": "disease_like_discoloration | dry_spot | ball_mark | divot | wear | machine_mark | weed | digging | unclear",
      "color": "茶", "shape": "ring | spots | irregular | streak",
      "size_note": "直径30cmほど",
      "change": "new | progressed | unchanged | improved | not_comparable" }
  ],
  "not_visible": [ { "area": "右奥", "reason": "shadow | backlight | dew_glare | obstructed | no_previous_photo" } ]
}

1つ目の理由は、change で日誌の並べ方をそろえられることです。 new と progressed の候補は日誌の先頭に、unchanged は「前回から変化なし」として後ろにまとめます。グリーンキーパーは、先頭の数行を見れば、その朝に見るべき場所が分かります。

2つ目は、kind と shape でホールをまたいだ集計ができることです。 「輪状の変色の progressed が何地点あるか」を毎朝数えれば、グリーンキーパーが手当ての範囲を決める材料になります。 手当てを決めるのはグリーンキーパーです。

3つ目は、手当てを写真と結び付けられることです。 日誌の行には、候補の番号と、担当が選んだ手当てと、翌日以降の同じ候補の change が並びます。「目土をした」の翌週に improved が続いているかを、写真と一緒に見返せます。

日誌の下書きの行は、次の形です。

システムへ連携する

散布の記録には、スクリプトから何も書きません。 散布の記録は、農薬の帳簿の項目に沿って人が書くものです。AIの候補が散布の記録の行を作る経路があると、散布していない日に「散布」の行が残るおそれがあります。

手当てと見立ての欄も、スクリプトから書きません。 欄の保護で、トリガーを作った共用のアカウントを編集者から外しておきます。

人が確認する

1. 担当が候補を選ぶ … 巡回の後、日誌の下書きを見て、候補ごとに「残す」「外す」を選びます。外すときは理由（露、影、カートの跡の見間違い など）を選びます
2. 担当が手当てを書く … 実際にした手当てを一覧から選びます。していないことは書きません
3. グリーンキーパーが見立てを書く … new と progressed の候補と、not_visible の出た地点を見て、病気か乾きか、どう手当てするかを書きます。必要なら現地で土の湿りを見ます
4. 散布を決めたら、散布の記録に書く … 薬剤の名前、量、場所を、使用計画と照らして書きます

3番目で現地を見るのは、写真に写らないものがあるからです。 土の湿り、根の張り、においは写真に写りません。写真の候補は現地を見に行く場所を絞るためのもので、現地を見る代わりではありません。

目標は、360件をならして1件4分です。 候補の無い地点は一覧で流し見て、new と progressed の候補に時間を使います。担当が外す候補が1件で半分を超えるなら、撮った条件の入れ方か、撮る地点の目印が崩れています。

例外に対処する

上から3行目までが大半を占めます。 どれもAIの精度の問題ではなく、撮る地点と時刻の問題です。 目印を決め直すほうが、指示の文をいじるより効きます。

記録を残す

• ホール・地点ごとの今回と前回の写真と、Gemini API が返した JSON の全文
• 指示に入れた撮った条件、芝の種類、季節
• 担当が外した候補と、その理由
• 担当が選んだ手当てと、グリーンキーパーの見立て
• 同じ候補の翌日以降の change の続き方
• グリーンキーパーの休みの日に、誰が見立ての欄を書いたか

最後の行が、手当てが効いたかを見る材料です。 補修や目土をした場所の change が、翌週に improved へ変わっていくかを写真で追えます。グリーンキーパーの経験を、次の担当が読める形で残すのはこの記録です。