位置データは正常系だけでなくエッジケースでもテストする
よく地図化された市の中心部の住所からは、システムが農村部のルート、係争中の国境、極地付近のクエリをどう扱うかについてほとんど何もわかりません。難しいケースを意図的にテストしてください。
「緯度と経度を使えばいい」が位置の精度を単純化しすぎている理由
2組の座標は、紙の上ではまったく同じに見えても、どこから来たかによってまったく異なる意味を持つことがあります。一方は、まさにその地点に立つデバイスから直接読み取ったGPSの値かもしれません。もう一方は、不完全またはあいまいな住所に対して得られた最良の一致がそれだったために返された、都市の重心かもしれません。単なる数値として表示されると、どちらも同じくらい精密に見えます。細かい用途で実際に信頼できるのがどちらなのかは、それを取り巻くメタデータだけが教えてくれます。
これが、座標の出所と精度が構築しているものにとって重要な場合に、「latとlonを使えばいい」が本当の意味で単純化しすぎである核心的な理由です。座標のペアそれ自体には、それがどのように導き出されたのか、どれだけの範囲を表しているのか、出所がその一致にどれだけの確信を持っていたのかについての情報がまったくありません。出所にかかわらずすべての座標ペアを同じように信頼できるものとして扱うと、配送のルーティングや位置情報に基づくアラートの発火といった判断を、特定の地点ではなく実際には都市全体の近似値に基づいて、アプリケーションが気づかないうちに下すことになります。
precisionとconfidenceのフィールドは、まさにこのギャップを埋めるために設計されています。precisionは、その座標がどの種類の一致（住居、通り、郵便番号、都市）から得られたかを示し、それはその地点が実世界でどれだけの範囲を表していると考えられるかを直接意味します。confidenceは、精度の段階とは別に、一致そのものがどれだけ確かだったかを示します。この2つを組み合わせることで、単なる座標のペアが、実際に判断の材料にできるものに変わります。単に「ここに地点があります」ではなく、「ここに地点があり、主張している精度はおおよそこのくらいで、その主張が正しいと私たちはこのくらい確信しています」ということです。
座標を保存したりサービス間で受け渡したりするあらゆるシステムに組み込む価値のある実践的な習慣は、生の数値だけでなく、precisionとconfidenceも一緒に持ち運ぶことです。座標のペアがそのコンテキストなしにデータベース、キュー、別の社内サービスに渡されると、下流でそれを使う人は、どれだけ信頼すべきかについて情報に基づいた判断を下す手段を失います。そして、単独の座標のペアには他に手がかりがないため、実際よりも精密なものとして扱ってしまう可能性が高くなります。
まさにこの理由から、私たちのジオコーディングと逆ジオコーディングのエンドポイントが返すすべてのジオコーディング結果には、座標とともにtype、precision、confidenceが含まれています。緯度と経度だけでなく、これらすべてを自分のパイプラインに通すことで、さらに下流のどのシステムも、元の検索の時点であなたのアプリケーションが得ていたのと同じ、情報に基づいた判断を下せるようになります。