Batch Geocoder API 開発者ガイド

ライフサイクルとジョブをリクエストします

Batch Geocoder API は、リクエストを非同期で処理します。 バッチジオ コーディングリクエストまたはリバースジオ コーディングリクエストを送信すると RequestId 、応答に要素が含まれます。 サービスがリクエストを受け入れ、エレメントの値が そのリクエストに対応する処理ジョブの一意の識別子であることを示します。 サービスはこのジョブにアドレス指定可能な領域を割り当て、それを使ってリクエストデータや出力情報、ステータス情報を保存する。 例えば、ジョブステータスを取得したり、ジョブに関連する追加アクションを起動したりするために、その後のクエリのパスを構築する際に RequestId を使用します。サーバーは、処理後 30 日間ジョブを保存します。つまり、以前に完了したジョブを再取得できます。

ジョブのステータスには、次のものがあります。
  • accepted
  • cancelled
  • completed
  • deleted
  • failed
  • running
  • submitted
ジョブステータスの詳細については、「ジョブステータス」を参照してください。

Batch Geocoder API に送信されたジョブを制御するに は、リクエスト内のRequestIdを組み合わせて、サポートされているactionリクエストパラメータの値(cancelrun、またはstatus)のいずれかを使用します。 詳細については、「API エンドポイント」および「リクエストパラメータ」を参照してください。