Safie Developers 仕様変更のお知らせ ※完了済み

---

お客様各位

いつもSafie Developers（https://developers.safie.link/ ）をご利用いただきありがとうございます。来月のバージョンアップに伴い、以下の仕様変更を予定しておりますので、事前にお知らせいたします。

変更予定日

2024年2月20日（火）を予定しています。

変更内容

1. 位置情報取得APIのレスポンス仕様変更 - API / SDK(JavaScript) 共通

Devices/位置情報取得APIにおいて、位置情報を取得できない場合に返却する値を以下のように変更します。

API

【変更前】

• 設定オフの場合

   HTTP/1.1 200 OK
   Content-Type: application/json
   {
       "gps_status": "off",
       "location": {
           "latitude": 0.0,
           "longitude": 0.0
       }
   }

• 設定オンかつ未取得の場合

   HTTP/1.1 200 OK
   Content-Type: application/json
   {
       "gps_status": "on",
       "location": {
           "latitude": 0.0,
           "longitude": 0.0
       }
   }

【変更後】

• 設定オフの場合

   HTTP/1.1 200 OK
   Content-Type: application/json
   {
       "gps_status": "off",
       "location": {
           "latitude": null,
           "longitude": null
       }
   }

• 設定オンかつ未取得の場合

   HTTP/1.1 200 OK
   Content-Type: application/json
   {
       "gps_status": "on",
       "location": {
           "latitude": null,
           "longitude": null
       }
   }

SDK(JavaScript)

QueryLocationResultインターフェースを以下のように変更します。

【変更前】

• 設定オフの場合

   {
       "gpsStatus": "off",
       "location": {
           "latitude": 0.0,
           "longitude": 0.0
       }
   }

• 設定オンかつ未取得の場合

   {
       "gpsStatus": "on",
       "location": {
           "latitude": 0.0,
           "longitude": 0.0
       }
   }

【変更後】

• 設定オフの場合

   {
       "gpsStatus": "off",
       "location": {
           "latitude": null,
           "longitude": null
       }
   }

• 設定オンかつ未取得の場合

   {
       "gpsStatus": "on",
       "location": {
           "latitude": null,
           "longitude": null
       }
   }

2. サムネイル取得の画像サイズ仕様変更 - API / SDK(JavaScript) 共通

Devices/サムネイル取得APIにおいて、取得できるサムネイル画像のサイズを以下のように変更します。これにより、一部の解像度の場合に画像が歪んでしまう事象が解消されます。

【変更前】

一律で640x360ピクセル

【変更後】

Devices/画像取得で得られる画像の縦1/2・横1/2のサイズ

ご質問・お問い合わせ

上記の通り仕様変更を予定しています。お使いいただいている機能が変更されますので、ご注意くださいませ。

また変更内容に関する事前のご質問・お問い合わせについては、お問い合わせフォーム（https://safie.jp/contact/api/）よりご連絡ください。

お客様にご満足いただけるサービスを提供できるよう引き続き努めてまいりますので、今後ともよろしくお願い申し上げます。

●2024年2月20日追記
　お知らせしていた内容の通り、2024年2月20日に仕様変更を行いました。

——

セーフィー株式会社
Safie Developers サポート窓口
平日10:00～17:00（土日祝祭日、年末年始等を除く）

---