Glossary

Application

Application is a container for the QWeather Data Service. You need to create an Application first and create multiple KEYs for accessing weather data. There are three types of Applications.

  • Dev Application: Access to QWeather data using the Dev Application is all free and is mainly used for individual developers, testing and small-scale use.
  • PRO Application: PRO Application is volume-based (a.k.a. pay-as-you-go), charging for the actual amount of data called, please refer to pricing.
  • Performance Application: For enterprise users with high access volume or higher requirements on availability, we provide Performance Application to meet the needs. Performance Application require additional service configuration fees.

The above Applications are different in data types and performance, please refer to comparison

KEY

API Key or KEY is a user key used for authorization. You need to pass this key when using QWeather API, SDK and Widget.

Public ID

Public ID is the public key of a certain data KEY of the user. When you use Signature Authentication to obtain data, you need to pass the Public ID.

Rank

Rank is an indication of the ranking of a city or region, it is calculated based on a variety of factors, such as: population, area, GDP, search popularity, etc. In GeoAPI, the respond data will refer to the Rank value of the city in addition to the relevance of the keywords. The range of Rank is 1-10, 1 means that the city or region is more populous, larger or more popular.

Coordinate

  • The GCJ-02 coordinate system should be used in mainland China, and the WGS-84 coordinate system should be used in other regions.
  • Query format: Longitude, Latitude (Longitude first and latitude second, separated by commas, decimal format, north latitude and east longitude are positive, and south latitude and west longitude are negative). For example: location=116.41,39.92

Administrative

In various countries around the world, there are different administrative levels. In order to facilitate understanding and convenient inquiries about the correct weather information, all cities with QWeather will belong to at least two administrative division levels. Please note that the administrative division level of mild weather is not exactly equal to the actual administrative division level of each country.

  • The code adm1, which represents the first-level administrative divisions, is generally the first-level administrative divisions of countries, such as provinces/states/prefectures/constituting countries. It is the first administrative division under the country, including municipalities/capitals/special zones, etc.
  • The code adm2, which represents a sub-administrative division, is generally a direct administrative division of a specific city or region. For example, the sub-administrative division of Yuhang District is Hangzhou City, or the sub-administrative division of Manhattan is New York City. If the direct administrative division of a city is equal to the first-level administrative division, then the direct superior administrative division of the city is the city itself. For example, the first-level administrative division of Shenzhen is Guangdong Province and the secondary administrative division is Shenzhen.

LocationID

LocationID is the ID of a city, region, or POI point. It is generally composed of numbers or letters + numbers, and is a unique identification of a location. LocationID can be obtained through the GeoAPI. The LocationID of China region and some POI points can also be downloaded through City List.

Adcode

Adcode is the Chinese administrative division code.

ISO 3166

ISO 3166 is a global country code standard issued by the International Organization for Standardization (ISO). The country code has two-letter codes, three-letter codes, and three-digit codes, and two-letter code (alpha-2) is used for QWeather.

POI

Point of Interest, the concept of POI in the QWeather includes: airports, ports, railway stations, China’s air quality monitoring stations and attractions.

Date Time

QWeather uses ISO8601:2004 as all date and time expression formats in v7 and above. The date and time are in local time.

  • Date format: YYYY-MM-DD, such as 2019-12-30, which represents December 30, 2019.
  • Long time format: YYYY-MM-DDTHH:MM±timezone, for example, 2019-12-30T08:35+0800, representing East Eight District at 8:35 AM on December 30, 2019.
  • Short time format: HH:MM, for example 20:31

Timezone

Timezone, the field name in the API is tz, it is in tz database format, or IANA time zone database.

Daylight Saving Time

isDST indicates whether it is currently in daylight saving time. The time in the weather data has been adjusted for daylight saving time, so you don’t need to do any further conversions.

UTC Offset

In GeoAPI, utcOffset indicates the offset between the current time of the area/city and UTC time. This offset has taken into account the situation of some countries entering the daylight saving time, so this offset is not exactly the same as the time zone offset. For example, the time zone of New York is America/New_York, which is 5 hours away from UTC. When New York enters daylight saving time on the second Sunday of March each year, the local time in New York is different from UTC by -4 hours. At this time, the value of utcOffset is -04:00

Public Time

pubTime is the time when the observing station or data source is released, and represents the time when the current data is released.

Update Time

updateTime is different from pubTime. This time is the time when the QWeather system updates the data and represents the time of the last update of the currently data.

  • The same updateTime can be used to determine whether the data content has changed, but different update times cannot be used to determine that the data content must have changed. In some cases, the calculation results of the meteorological model may get the same result at different update times .
  • Due to weather data is constantly updated, the exact update time cannot be determined. Please refer to the updateTime field of the data returned by the API/SDK.
Data Update interval
Warning 5 minutes
Daily forecast 1-8 hour
Hourly forecast 1 hour
Weather indices 1 hour
Real-time data 10-20 minutes
Minutely rainfall 10-20 minutes
Imagery 30-60 minutes

iOS Bundle identifier

Check Bundle Identifier in Xcode.

Please note that Bundle ID is limited to English letters, numbers, dashes and underscores, and English letters must be used at the beginning of each paragraph, and English letters or numbers must be used at the end of each paragraph.

Example Is that correct?
abc.xyz.def YES
abc.xyz YES
abc.x1.y-z YES
abc.1x.2y.3z NO
1a.xyz.def NO
abc.xyz_ NO

Android Package Name

Open the AndroidManifest.xml configuration file of the Android project, and the content corresponding to the package attribute is the Package Name.

Please note that the Android Package Name is limited to English letters, numbers, dashes and underscores, and English letters must be used at the beginning of each paragraph, and English letters or numbers must be used at the end of each paragraph.

Example Is that correct?
abc.xyz.def YES
abc.xyz YES
abc.x1.y-z YES
abc.1x.2y.3z NO
1a.xyz.def NO
abc.xyz_ NO

Max Connections

The Maximum Connections that an API or SDK service can carry. When the connection exceeds the maximum number of connections limited by the current application, the new connection request will be discarded.

QPM

QPM (Query Per Minute), the number of requests per minute. Requests exceeding the QPM will return an error code and resume after the next minute.

  • QPM is different for different Account Type.
  • QPM is calculated by a single Application, all data keys under one application share QPM, and different Applications calculate QPM separately.
Account type QPM
Registered User 100
Individual Developer 500
Enterprise Developer 500
Pro Application 3000
Performance Application 50000

Wind Scale

The Wind Scale is used for direct display and is not recommended as an enumerated item; for example, if a higher level of wind appears in the future or the standard of the wind level is changed, if the enumeration item is used, it will not be matched. Please use it with caution.

The Wind Scale is based on the wind speed, please refer to Wind Speed ​​and Wind Speed ​​Comparison, and QWeather uses KM/H as the unit.

When the Wind Scale is 0, the wind direction angle is -1, and the wind direction is no continuous wind direction.