シングルショットリクエストと サブスクリプション

HERE GNSS API では、 HERE GNSS サービスから 2 つの異なるモードでデータを要求できます。

シングルショットリクエスト

シングルショットリクエストを作成すると、サービスは Message 現在のデータを含む 1 つの応答 ( たとえば、 GPS 衛星の現在のナビゲーションモデル ) を返します。

サービスから単 Message一の応答が送信された後、シングルショット要求が終了します。

この WebSocket 接続で他のシングルショットリクエストを作成しないか、データにサブスクライブしない場合、接続は約 60 秒後に終了します。

サブスクリプション

データにサブスクライブすると 、ただちにデータは取得されませんが、サブスクライブしたデータが変更された場合（たとえば、変更されるたびに）、 GPS 衛星のナビゲーションモデルが変更されます。

サービスは接続を開いたままにし、ユーザーが接続を閉じるか、データからサブスクライブを解除するまでサブスクリプションデータの送信を続行します。

サブスクライブしているデータの変更が非常に遅い場合、サービスは WebSocket の ping メッセージを送信して、接続を開いたままにします。 WebSocket ライブラリは、 pong メッセージで自動的に応答します (WebSocket 仕様に従って実装されている場合 ) 。

同じ接続内のさまざまなデータ型にサブスクライブできます。 この場合、受信した各データ Message 型に複数のデータ型からの更新が含まれている可能性があります。

通信の問題などにより接続が終了した場合は、 HERE GNSS サービスに再接続した後でデータを再度サブスクライブする必要があります。 再接続を試みる場合は、指数バックオフを使用します。