POI Lookup
POI Lookup API provides basic information of POI(scenic spot, tide stations, currents stations, etc.)
Interface code (Enum) | Interface | Class |
---|---|---|
INQUIRE_TYPE_GEO_POI_LOOKUP | POI Lookup | GeoBaseClass |
Request Parameters
If no optional parameters are set, the default value will be used.
-
location
(required)The location to be queried, support text, LocationID, comma-separated longitude and latitude (decimal, up to 2 decimal places), Adcode(Chinese cities only). For example:location=beijing
orlocation=116.41,39.92
-
appKey
(required)API authentication key, please refer to How To Get Your Key. For example:appKey=12334567890ABC
-
type
(required)Choose to search for a certain type of POI.scenic
Scenic SpotCSTA
Currents StationTSTA
Tide Station
-
city
Search for POI within a given city. The city name can be text or the city’s LocationID.The city name is an exact match. It is recommended to use LocaitonID. If the text cannot be matched, the data returned will be empty.
-
number
Number of the results in response, from 1 to 20, 10 is the default. -
lang
Multi-language, default Chinese, if data does not match the language you set, it will return in English or its native language. Language parameter please refer to Language
Sample Code
QWeatherConfigInstance.publicID = @"publicID";
QWeatherConfigInstance.appKey = @"key";
QWeatherConfigInstance.appType = APP_TYPE_BIZ;
QWeatherConfigInstance.location = @"beijing";
[QWeatherConfigInstance weatherWithInquireType:INQUIRE_TYPE_GEO_POI_LOOKUP WithSuccess:^(GeoBaseClass *responseObject) {
NSLog(@"Description->%@",[responseObject description]);
} faileureForError:^(NSError *error) {
NSLog(@"error->%@",error);
}];
Response
Parameters | Description | Example |
---|---|---|
code | Status code, please refer to Status Code | 200 |
location.name | Location Name | Nanshan District |
location.cid | Location ID | 101280604 |
location.lat | Latitude of the location | 22.53122 |
location.lon | Longitude of the location | 113.92942 |
location.adm2 | Name of the superior administrative division of the location | Shenzhen |
location.adm1 | The first-level administrative region of the location | Guangdong Province |
location.country | Country name of the location | China |
location.tz | Location Timezone | +0800 |
location.utcOffset | The number of hours offset between local time and UTC time, refer to UTC-Offset | +08:00 |
location.isDst | Is the location currently observing Daylight Saving time1 in daylight saving time 0 not in daylight saving time |
0 |
location.type | POI type | scenic |
location.rank | Location Rank | 10 |
location.fxLink | Responsive web page of this location, easy to embed in your website or APP | http://hfx.link/34T5 |
refer.sources | Data source and other statements, may be null | |
refer.license | License, may be null |