有効期限のないAPIキーの問題点
何年も前に発行され、一度もローテーションされず、今も有効なキーは、便利なものではありません。何年も誰も実際に確認していない負債です。
座標の精度をめぐるマーケティングが取り違えていること
小数点以下15桁まで返される緯度と経度は、驚くほど正確に見えます。座標の小数点以下15桁目は原子より小さい距離に相当します。このこと自体が、表示されている精密さが根拠となる一致の正確さとは何の関係もないことを示すすぐにわかるシグナルのはずです。郵便区域の中心点、建物レベルの一致、あるいは大まかな区域の推定から得られたジオコーディング結果は、レスポンスの小数点以下の桁が多いからといって、より正確になるわけではありません。単に桁が多いだけです。
精密さと正確さというこの区別は、位置データの見せ方の中で絶えず曖昧にされています。精密さとは、数字が何桁あるかです。正確さとは、その数字が実際の位置にどれだけ近いかです。座標は極めて精密でありながら大きく間違っていることがあります。長い小数の文字列を前面に出すレスポンス形式は、読み手に両者が同じものだと思い込ませます。しかし実際には、一方が他方の欠如を覆い隠せるという点以外、両者にはまったく関係がありません。
レスポンスにできるより誠実なことは、根拠となる手法が裏付けられないかもしれない確信の度合いを小数の長さでほのめかすのではなく、実際にどのような種類の一致がその座標を生み出したのかを説明することだと私たちは考えます。建物レベルの一致と市の中心点へのフォールバックは、小数の精密さだけでなく、種類そのものが異なります。その違いを「小数の桁が多いほど良い」に押し込めてしまうと、地図にピンを立てる場合でも配達車両のルートを決める場合でも、ある結果が自分のユースケースに十分かどうかを判断するために開発者が必要とする、まさにその情報が隠されてしまいます。
これは、私たちが自社のジオコーディング、逆ジオコーディング、オートコンプリートのエンドポイントの説明に慎重である理由に直結しています。長い小数の尾を付けた座標を返し、私たちがはっきりとはするつもりのない確信度の主張の代わりにそれを使うのは簡単でしょう。私たちは、根拠となるデータが正当化する以上のことを小数の書式でほのめかすよりも、エンドポイントが何を返すのかを具体的に示し、実際の一致情報そのものに語らせるほうを選びます。
ここには、私たちが自社のAPIをどう作ったかにとどまらず、ジオコーディングAPIを利用するすべての人にとっての実践的な教訓があります。座標の小数点以下の桁数は品質の証拠ではありません。重要なのは、実際に何が、どの程度の具体性で一致したのかをレスポンスが平易な言葉で伝えているかどうかです。そうすれば、これから下そうとしている判断にとって、その具体的な答えが十分かどうかを自分で決められます。小数点以下に長く続く数字が答えているのは書式についての質問です。本当に重要な質問、つまりそれらの数字が表す世界の中の地点が正しいかどうかには答えていません。