Google Static Maps API の仕様が変わって携帯で画像が表示されなくなった

2010/04/06 ご指摘いただき間違いに気付いたので修正しました。

Google Static Maps API（以下GSMAPI） の仕様が変わりました。正確な日付はわからないのですが、現在把握できている変更箇所は2点です。既存の方法だと画像が出力されない内容が含まれるため対応が必須です。本エントリーは特にモバイル版の案件を抱えていて、かつGIF形式で出力させる必要がある方のためにアウトプットします。（ほぼ自分用の備忘録ですけど）

■状態
（1）出力画像形式がデフォルトでGIFではなくPNG形式で出力されるようになった。
（2）パラメータ「&sensor=TRUE_OR_FALSE」が追加された。

■（1）の対応策
パラメータ（&key=より前）に&format=gifと指定する。
例）&format=gif&key=XXXX

■（1）の解説
日本語ドキュメントではデフォルトでGIF形式で出力されると説明があるのに対して、英語ドキュメントではPNG形式がデフォルトで出力されると説明があり、情報が交錯。これでハマりました。現在デフォルトでPNGが出力されるので、PNG以外で出力させたい場合はformatを指定する必要があります。GIF形式ならgif、JPG形式ならjpgと指定すると適宜出力されます。

■（2）の対応策
&sensor=trueか、&sensor=falseのどちらか一方を必ず指定する。
例）&sensor=false&key=XXXX

■（2）の解説
これは公式ドキュメントでも説明があるので読んだ方が早いです。GPI搭載機種向けのパラメータで、GSMAPIでも現在位置を利用してあんなことやこんなことができるようになりました。ただしGPI非搭載の機種だからと言ってパラメータを削除すればよいわけでなく、「&sensor=false」としなければ画像が出力されないので注意が必要です。

■雑感
某サイトでモバイル版の地図表示にGSMAPIを利用していたのですが（諸事情ありdocomo携帯をメインに実装していました）、docomo携帯はほとんどの機種でPNG画像に非対応で表示できないため、今回の仕様変更で何も表示できないという状態に。さらにsensorパラメータの追加も相まって問題箇所の切り分けに手間取りました。

結構同じような利用形態で運用されてる方いると思います。このエントリーが何かの縁で役に立てば幸い。

冒頭にも追記しましたが、一部（というか根本的に）間違った認識のまま記事を公開していたので、修正しました。デフォルトでGIF出力されなくなったことは事実なのですが、具体的には以下のように勘違いしていました。

誤：Google Static Maps APIのバージョンが上がったため
正：Google Static Maps APIのバージョンは変わっていず、仕様が変わったため

いや～恥ずかしい。かなり時間もたってしまってからですが...間違った情報をアウトプットし続けていたこと、訂正してお詫びいたします。また指摘していただいた方に心から感謝します...。ありがとうございました。