Open-API Introduction

User approval may take about 7 days

Open-API Introduction

GEMS Open-API

1. GEMS Open-API

GEMS Open-API is an interface that enables users to more easily access and use GEMS images and data products to serve their own purposes such as developing web services and mobile applications that integrates GEMS data.

2. Who can use Open-API?

Any user who wants to make use of GEMS data.

3. How to use Open-API

  1. The Open-API service requires a user key.
  2. Go to Open-API Key Issuance and request a key.
  3. Once your request is complete, your key code will be sent to you via email.
  4. You can use the key to create a URL for data download at Create Open-API URL.
  • Request for the issuance of a key at the "Issue the key" page
  • Approval by admin
  • A Key issued
  • Use the key to create an URL at Create Open-API URL
  • Run the program

4. Open-API available data

Sample usage of Open-API : api_sample_downlaod.zip

○ image_list_sample.sh : To search the list of image files over a period

○ image_down_sample.sh : To download the image file for a specific time slot

○ data_list_sample.sh : To search the list of data files over a period

Open-API offering image outputs

Satellite Level Type English name Area

Open-API offering data outputs

Satellite Level Type English name

Open-API URL Parameters

Parameter Type Description Parameter
Data format IMAGE image
DATA data
Search type Observation Time Search getFileDateList
Filename Search getFileList
Download getFileItem
Format json Type JSON
xml Type XML
text Type TEXT
Observation Date Download Date date=yyyyMMddHHmm
Period start date sDate=yyyyMMddHHmm
End of Period Date eDate=yyyyMMddHHmm