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
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 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.
- 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:
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 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 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.
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, 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 #
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
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
updateTimecan 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
updateTimefield of the data returned by the API/SDK.
|Daily forecast||1-8 hour|
|Hourly forecast||1 hour|
|Weather indices||1 hour|
|Real-time data||10-20 minutes|
|Minutely rainfall||10-20 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?|
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?|
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 (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.
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.