tracking-pettracer-location

PetTracer の位置情報に関する根拠

このスキルは残してください。特定の飼い主の照会タスクを解決します。今回のレビューでは、現在利用できる公式の公開開発者向け API や代替 CLI は確認できていません。そのため、ポータル用ヘルパーは明確に非公式のものであり、ベンダーがサポートするクライアントでも、リアルタイム追跡を保証するものでもありません。動作やアカウント契約が異なる場合は、公式アプリ／ポータルを優先してください。

対象と権限を確認する

ユーザーが所有する、または確認を許可されているアカウント／首輪のみを使用してください。座標をペットの位置として解釈する前に、アカウント内の端末一覧と公式アプリで実際の端末 ID を確認してください。HomeStation に設定された位置は、首輪の GPS 測位ではありません。端末タイプのフィールドがない場合、そのタイプは未確認のままです。任意の名前やレスポンスの最初の項目からタイプを推測しないでください。

SKILL_DIR をこのインストール済みスキルのディレクトリに解決してください。PETTRACER_TOKEN を非公開で設定するか、認証済みログインには PETTRACER_USERNAME と PETTRACER_PASSWORD を設定してください。チャットで認証情報を求めたり、コマンド引数に渡したりしないでください。このヘルパーはトークンを保存または表示せず、任意の API オリジンや認証情報のリダイレクトも受け付けません。

python "$SKILL_DIR/scripts/pettracer.py" list
python "$SKILL_DIR/scripts/pettracer.py" locate --device-id 12345 --max-age-seconds 900

サンプル ID を、確認済みの首輪 ID に置き換えてください。既定の 900 秒はローカルで使用する報告しきい値であり、メーカーによる保証でも、すべての追跡モードに適したしきい値でもありません。recent は、指定した測定時刻が選択したしきい値を満たしていることを意味します。その座標にペットがとどまっているという意味ではありません。

タイムスタンプをそのまま扱う

測位の経過時間の計算には timeMeasure のみを使用してください。timeDb と lastContact は別々に扱ってください。新しいデータベースの更新や接続があっても、古い位置情報が新しくなるわけではありません。タイムゾーンのない日時は、暗黙に UTC として扱わず、無効としてください。不明な時刻や未来の時刻は明示的な状態として扱い、既定で新しいものと見なしてはいけません。取得時刻と併せて、実際の測位時刻／タイムゾーンと経過時間を表示してください。

このヘルパーは、有限の緯度／経度の範囲を検証し、ゼロ値をそのまま保持します。検証済みの校正／単位の仕様がない限り、バッテリー残量を推定したり、生の信号／精度フィールドを変換したりしません。acc と horiPrec は単位未確認の個別の生の品質フィールドです。コミュニティのインテグレーションでそう扱われていたというだけで、どちらかをメートル単位の半径と呼んではいけません。home は端末のフラグであり、ペットが正確なジオフェンス内にいることの証明ではありません。

履歴

明示的にタイムゾーンを指定した期間を使用してください。ヘルパーへのリクエストは最大 7 日間です。

python "$SKILL_DIR/scripts/pettracer.py" history --device-id 12345 \
  --from-time 2026-09-13T06:00:00+02:00 --to-time 2026-09-13T12:00:00+02:00

これらは時刻の例であり、現在リクエストされている期間ではありません。ヘルパーはプロバイダーの順序を保持し、完全性は未確認であることを示します。返されたタイムスタンプがリクエストした期間内にあるか確認してください。不明な点や期間外の点は、ラベルを付けたままにしてください。ルートを作成するときは、元のデータと欠落区間を保持しながら、意図的に並べ替えたり重複を削除したりしてください。まばらな GPS 測位を結ぶ直線は、実際に移動した経路ではありません。

ライブ更新とモード

飼い主による即時の捜索／ライブモードには、公式アプリ／ポータルを使用してください。更新を購読しても、それだけで首輪に新しい測位を指示することにはなりません。モードを変更すると、バッテリーや端末の動作に影響することがあります。位置情報を読み取るついでに設定を変更しないでください。以前の無期限ウォッチャーは削除されています。ポータルとストリーミング に残されているプロトコルのメモは、明示的な範囲を指定した新しいインテグレーションに必要な根拠を説明するものであり、テスト済みのライブクライアントを示すものではありません。

認可された稼働中のサービス／スケジューラーが実際に設定されていない限り、継続的な監視や将来の通知を約束しないでください。ストリームの失敗や GPS 測位がないことは、ペットが安全である、移動していない、屋内にいる、または自宅にいるという根拠にはなりません。

正確な位置情報を返す

選択した首輪、最新の有効な測定座標、測定時刻、経過時間／鮮度の状態、および関連する欠損データや品質情報を示します。最終接続時刻は別に報告してください。地図リンクを含めると、正確な位置情報が第三者に開示される可能性があります。ユーザーの依頼に応じて適切な場合のみ含め、未加工の履歴は非公開にしてください。精度を誇張したり、必要もないのに正確な住所を逆ジオコーディングしたり、人の行動パターンを推測したりしないでください。

終了コード 0 は読み取りが処理されたことを示すものであり、最近の GPS 測位が存在することを示すものではありません。last_fix.freshness と device_type_verified を確認してください。測位情報の欠損／無効、スキーマエラー、認証失敗、履歴が空であることは、それぞれ異なる結果です。リクエストごとのソケットタイムアウトと 2 MiB のレスポンス上限は、処理全体の所要時間を保証するものではありません。自動再試行や再ログインのループはありません。再試行する前に、想定外のエンドポイント／スキーマを確認してください。

メンテナー向け：python -m unittest discover -s "$SKILL_DIR/tests" -v では、解析、選択、リクエストの境界、およびモックされた通信をテストします。このレビューでは、実際のアカウントや首輪への問い合わせは行っていません。ベンダーの運用サポート：https://help.pettracer.com/。

履歴の結果には各レコードの原文が保持され、測定時刻が指定された包括的な期間の内側、外側、または不明のいずれに該当するかが示されます。これは測位情報の経過時間とは別のものです。オブジェクトではない lastPos はスキーマエラーであり、GPS 測位がないことを示すものではありません。