Map Tile API Developer's Guide

POI Categories

The /meta/pois resource handles requests for POI Categories details.

The following URL shows the format of a request and the table below explains each parameter.

Note: Please check that the first category index is '1' and not '0'.
https://{1-4}.base.maps.cit.api.here.com
/maptile/2.1/meta/pois
?app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}
&{param}={value}

Mandatory Query Parameters

The following table lists the mandatory parameters that need to be specified with every request. Not specifying these parameters will make the system reject the request.

Table 1. Mandatory Query Parameters
Parameter Type Description
app_id String A URL-safe encoded string obtained during the application registration. See Acquiring Credentials for information on getting credentials.
app_code String A URL-safe encoded string obtained during the application registration. See Acquiring Credentials for information on getting credentials.

Note: Usage of token is accepted although is deprecated

Table 2. POI Information Specific Query paramaters
Parameter Type Description
output String Output specifier. The API supports the following output specifier values (and output formats):
  • text – delivers the API metadata in plain text format (this is the default). The index is listed first and next to it the category name.
  • json – delivers the API metadata in JSON format. For this format the index is not listed as it is implicit from the position in the array.

Example with JSON output

The following example shows a request addressed to the /meta/pois resource.

Note: Please note the information below is just an example so it might be outdated, please check the latest result for an updated list of categories.
https://{1-4}.base.maps.cit.api.here.com
/maptile/2.1/meta/pois
?app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}
&output=json

The response contains information as shown in this example.


{"pois" : [
 "Restaurant",
 "Casual Dining",
 "Fine Dining",
 "Take Out and Delivery Only",
 "Food Market-Stall",
 "Taqueria",
 "Deli",
 "Cafeteria",
 "Bistro",
 "Fast Food",
 "Hawker Centre",
 "Coffee-Tea",
 "Coffee Shop",
 "Tea House",
 "Nightlife-Entertainment",
 "Bar-Pub-Stube-Biergarten",
 "Night Club",
 "Dancing",
 "Karaoke",
 "Live Entertainment-Music",
 "Billiards-Pool Hall",
 "Video Arcade-Game Room",
 "Jazz Club",
 "Adult Entertainment",
 "Cocktail Lounge",
 "Cinema",
 "Theatre, Music and Culture",
 "Performing Arts",
 "Gambling-Lottery-Betting",
 "Casino",
 "Lottery Booth",
 "Landmark-Attraction",
 "Tourist Attraction",
 "Gallery",
 "Historical Monument",
 "Winery",
 "Flyover",
 "Named Intersection-Chowk",
 "Brewery",
 "Distillery",
 "Museum",
 "Science Museum",
 "Children's Museum",
 "History Museum",
 "Art Museum",
 "Religious Place",
 "Church",
 "Temple",
 "Synagogue",
 "Ashram",
 "Mosque",
 "Other Place of Worship",
 "Body of water",
 "Reservoir",
 "Waterfall",
 "Bay-Harbor",
 "River",
 "Canal",
 "Lake",
 "Mountain or Hill",
 "Mountain Passes",
 "Mountain Peaks",
 "Undersea Feature",
 "Forest, Heath or Other Vegetation",
 "Natural and Geographical",
 "Public Sports Airport",
 "Airport",
 "Airport Terminal",
 "Train Station",
 "Bus Station",
 "Underground Train-Subway",
 "Commuter Rail Station",
 "Commuter Train",
 "Public Transit Access",
 "Transportation Service",
 "Public Transit Stop",
 "Local Transit",
 "Ferry Terminal",
 "Boat Ferry",
 "Rail Ferry",
 "Taxi Stand",
 "Highway Exit",
 "Tollbooth",
 "Bicycle Sharing Location",
 "Bicycle Parking",
 "Weigh Station",
 "Cargo Center",
 "Rail Yard",
 "Seaport-Harbour",
 "Airport Cargo",
 "Couriers",
 "Cargo Transportation",
 "Delivery Entrance",
 "Loading Dock",
 "Loading Zone",
 "Rest Area",
 "Complete Rest Area",
 "Parking and Rest Room Only",
 "Parking Only",
 "Motorway Service Area",
 "Scenic Overlook",
 "Hotel or Motel",
 "Hotel",
 "Motel",
 "Lodging",
 "Hostel",
 "Campground",
 "Guest House",
 "Bed and Breakfast",
 "Holiday Park",
 "Short-Time Motel",
 "Trekking Hut",
 "Off-Road Vehicle Area",
 "Park-Recreation",
 "Park-Recreation Area",
 "Sports Field",
 "Garden",
 "Beach",
 "Recreation Center",
 "Ski Lift",
 "Scenic Point",
 "Surf Life Savings Clubs",
 "Bicycle Trailhead",
 "Hiking Trailhead",
 "Off Road Trailhead",
 "Trailhead",
 "Amusement or Holiday Park",
 "Amusement Park",
 "Zoo",
 "Wild Animal Park",
 "Wildlife Refuge",
 "Aquarium",
 "Ski Resort",
 "Animal Park",
 "Water Park",
 "Other Convenience Store",
 "Convenience Store",
 "Shopping Mall",
 "Department Store",
 "Food-Beverage Specialty Store",
 "Grocery",
 "Specialty Food Store",
 "Wine and Liquor",
 "Bakery and Baked Goods Store",
 "Sweet Shop",
 "Butcher",
 "Dairy Goods",
 "Drug-Pharmacy",
 "Drug Store",
 "Pharmacy",
 "Consumer Electronics Store",
 "Mobile Retailer",
 "Mobile Service Center",
 "Computer and Software",
 "Entertainment Electronics",
 "Electronics",
 "Hardware, House and Garden",
 "Home Improvement-Hardware Store",
 "Home Specialty Store",
 "Floor and Carpet",
 "Furniture Store",
 "Garden Center",
 "Glass and Window",
 "Lumber",
 "Major Appliance",
 "Power Equipment Dealer",
 "Paint Store",
 "Other Bookshop",
 "Book Store",
 "Clothing and Accessories",
 "Men's Apparel",
 "Women's Apparel",
 "Children's Apparel",
 "Shoes-Footwear",
 "Specialty Clothing Store",
 "Consumer Goods",
 "Sporting Goods Store",
 "Office Supply and Services Store",
 "Specialty Store",
 "Pet Supply",
 "Warehouse-Wholesale Store",
 "General Merchandise",
 "Discount Store",
 "Flowers and Jewelry",
 "Variety Store",
 "Gift, Antique and Art",
 "Hair and Beauty",
 "Record, CD and Video",
 "Video and Game Rental",
 "Bicycle and Bicycle Accessories Shop",
 "Market",
 "Motorcycle Accessories",
 "Non-Store Retailers",
 "Pawnshop",
 "Used-Second Hand Merchandise Stores",
 "Adult Shop",
 "Arts and Crafts Supplies",
 "Florist",
 "Jeweler",
 "Toy Store",
 "Bank",
 "ATM",
 "Money Transferring Service",
 "Check Cashing Service-Currency Exchange",
 "Communication-Media",
 "Telephone Service",
 "Commerical Services",
 "Advertising-Marketing, PR and Market Research",
 "Catering and Other Food Services",
 "Construction",
 "Customer Care-Service Center",
 "Engineering and Scientific Services",
 "Farming",
 "Food Production",
 "Human Resources and Recruiting Services",
 "Investigation Services",
 "IT and Office Equipment Services",
 "Landscaping Services",
 "Locksmiths and Security Systems Services",
 "Management and Consulting Services",
 "Manufacturing",
 "Mining",
 "Modeling Agencies",
 "Motorcycle Service and Maintenance",
 "Organizations and Societies",
 "Entertainment and Recreation",
 "Finance and Insurance",
 "Healthcare and Healthcare Support Services",
 "Real Estate and Brokers",
 "Rental and Leasing",
 "Repair and Maintenance Services",
 "Printing and Publishing",
 "Specialty Trade Contractors",
 "Towing Service",
 "Translation and Interpretation Services",
 "Apartment Rental-Flat Rental",
 "B2B Sales and Services",
 "B2B Restaurant Services",
 "Aviation",
 "Interior and Exterior Design",
 "Property Management",
 "Financial Investment Firm",
 "Business Facility",
 "Police Station",
 "Police Services-Security",
 "Fire Department",
 "Ambulance Services",
 "Consumer Services",
 "Travel Agent-Ticketing",
 "Dry Cleaning and Laundry",
 "Attorney",
 "Banquet Hall",
 "Boating",
 "Business Service",
 "Funeral Director",
 "Mover",
 "Photography",
 "Realtor",
 "Repair Service",
 "Social Service",
 "Storage",
 "Tailor and Alteration",
 "Tax Service",
 "Utilities",
 "Waste and Sanitary",
 "Bicycle Service and Maintenance",
 "Bill Payment Service",
 "Body Piercing and Tattoos",
 "Wedding Services and Bridal Studio",
 "Internet Cafe",
 "Kindergarten and Childcare",
 "Maid Services",
 "Marriage and Match Making Services",
 "Public Administration",
 "Misc. Consumer Services",
 "Self Service Kiosk",
 "Wellness Center and Services",
 "Pet Care",
 "Legal Services",
 "Tanning Salon",
 "Recycling Center",
 "Electrical",
 "Plumbing",
 "Post Office",
 "Post Box",
 "Tourist Information",
 "Fueling Station",
 "Petrol-Gasoline Station",
 "EV Charging Station",
 "Automobile Dealership-New Cars",
 "Automobile Dealership-Used Cars",
 "Motorcycle Dealership",
 "Car Repair-Service",
 "Car Wash-Detailing",
 "Car Repair",
 "Auto Parts",
 "Emission Testing",
 "Tire Repair",
 "Truck Repair",
 "Van Repair",
 "Road Assistance",
 "Automobile Club",
 "Rental Car Agency",
 "Truck-Semi Dealer-Services",
 "Truck Dealership",
 "Truck Parking",
 "Truck Stop-Plaza",
 "Truck Wash",
 "Hospital or Health Care Facility",
 "Dentist-Dental Office",
 "Family-General Practice Physicians",
 "Psychiatric Institute",
 "Nursing Home",
 "Medical Services-Clinics",
 "Hospital",
 "Optical",
 "Veterinarian",
 "Hospital Emergency Room",
 "Therapist",
 "Chiropractor",
 "Blood Bank",
 "Government or Community Facility",
 "City Hall",
 "Embassy",
 "Military Base",
 "County Council",
 "Civic-Community Center",
 "Court House",
 "Government Office",
 "Border Crossing",
 "Agricultural Checkpoint",
 "Military Checkpoint",
 "Education Facility",
 "Higher Education",
 "School",
 "Training and Development",
 "Coaching Institute",
 "Fine Arts",
 "Language Studies",
 "Other Library",
 "Library",
 "Fair and Convention Facility",
 "Convention-Exhibition Center",
 "Parking Facility",
 "Parking Garage-Parking House",
 "Parking Lot",
 "Park and Ride",
 "Cellphone Parking Lot",
 "Sports Facility-Venue",
 "Sports Complex-Stadium",
 "Ice Skating Rink",
 "Swimming Pool",
 "Tennis Court",
 "Bowling Center",
 "Indoor Ski",
 "Hockey",
 "Racquetball Court",
 "Shooting Range",
 "Soccer Club",
 "Squash Court",
 "Fitness-Health Club",
 "Indoor Sports",
 "Golf Course",
 "Golf Practice Range",
 "Race Track",
 "Sporting Instruction and Camps",
 "Sports Activities",
 "Basketball",
 "Badminton",
 "Rugby",
 "Diving Center",
 "Facilities",
 "Cemetery",
 "Crematorium",
 "Public Restroom-Toilets",
 "Clubhouse",
 "Offices",
 "Registration Office",
 "Hamlet",
 "Named Place",
 "Neighborhood",
 "Outdoor Area-Complex",
 "Industrial Zone",
 "Marina",
 "RV Parks",
 "Collective Community",
 "Island",
 "Residential Area-Building",
 "Business Area"
]
}

Example with plain text output

The following example shows a request addressed to the /meta/pois resource.

Note: Please note the information below is just an example so it might be outdated, please check the latest result for an updated list of categories.
https://{1-4}.base.maps.cit.api.here.com
/maptile/2.1/meta/pois
?app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}

The response contains information as shown in this example.


1 = Restaurant,
2 = Casual Dining,
3 = Fine Dining,
4 = Take Out and Delivery Only,
5 = Food Market-Stall,
6 = Taqueria,
7 = Deli,
8 = Cafeteria,
9 = Bistro,
10 = Fast Food,
11 = Hawker Centre,
12 = Coffee-Tea,
13 = Coffee Shop,
14 = Tea House,
15 = Nightlife-Entertainment,
16 = Bar-Pub-Stube-Biergarten,
17 = Night Club,
18 = Dancing,
19 = Karaoke,
20 = Live Entertainment-Music,
21 = Billiards-Pool Hall,
22 = Video Arcade-Game Room,
23 = Jazz Club,
24 = Adult Entertainment,
25 = Cocktail Lounge,
26 = Cinema,
27 = Theatre, Music and Culture,
28 = Performing Arts,
29 = Gambling-Lottery-Betting,
30 = Casino,
31 = Lottery Booth,
32 = Landmark-Attraction,
33 = Tourist Attraction,
34 = Gallery,
35 = Historical Monument,
36 = Winery,
37 = Flyover,
38 = Named Intersection-Chowk,
39 = Brewery,
40 = Distillery,
41 = Museum,
42 = Science Museum,
43 = Children's Museum,
44 = History Museum,
45 = Art Museum,
46 = Religious Place,
47 = Church,
48 = Temple,
49 = Synagogue,
50 = Ashram,
51 = Mosque,
52 = Other Place of Worship,
53 = Body of water,
54 = Reservoir,
55 = Waterfall,
56 = Bay-Harbor,
57 = River,
58 = Canal,
59 = Lake,
60 = Mountain or Hill,
61 = Mountain Passes,
62 = Mountain Peaks,
63 = Undersea Feature,
64 = Forest, Heath or Other Vegetation,
65 = Natural and Geographical,
66 = Public Sports Airport,
67 = Airport,
68 = Airport Terminal,
69 = Train Station,
70 = Bus Station,
71 = Underground Train-Subway,
72 = Commuter Rail Station,
73 = Commuter Train,
74 = Public Transit Access,
75 = Transportation Service,
76 = Public Transit Stop,
77 = Local Transit,
78 = Ferry Terminal,
79 = Boat Ferry,
80 = Rail Ferry,
81 = Taxi Stand,
82 = Highway Exit,
83 = Tollbooth,
84 = Bicycle Sharing Location,
85 = Bicycle Parking,
86 = Weigh Station,
87 = Cargo Center,
88 = Rail Yard,
89 = Seaport-Harbour,
90 = Airport Cargo,
91 = Couriers,
92 = Cargo Transportation,
93 = Delivery Entrance,
94 = Loading Dock,
95 = Loading Zone,
96 = Rest Area,
97 = Complete Rest Area,
98 = Parking and Rest Room Only,
99 = Parking Only,
100 = Motorway Service Area,
101 = Scenic Overlook,
102 = Hotel or Motel,
103 = Hotel,
104 = Motel,
105 = Lodging,
106 = Hostel,
107 = Campground,
108 = Guest House,
109 = Bed and Breakfast,
110 = Holiday Park,
111 = Short-Time Motel,
112 = Trekking Hut,
113 = Off-Road Vehicle Area,
114 = Park-Recreation,
115 = Park-Recreation Area,
116 = Sports Field,
117 = Garden,
118 = Beach,
119 = Recreation Center,
120 = Ski Lift,
121 = Scenic Point,
122 = Surf Life Savings Clubs,
123 = Bicycle Trailhead,
124 = Hiking Trailhead,
125 = Off Road Trailhead,
126 = Trailhead,
127 = Amusement or Holiday Park,
128 = Amusement Park,
129 = Zoo,
130 = Wild Animal Park,
131 = Wildlife Refuge,
132 = Aquarium,
133 = Ski Resort,
134 = Animal Park,
135 = Water Park,
136 = Other Convenience Store,
137 = Convenience Store,
138 = Shopping Mall,
139 = Department Store,
140 = Food-Beverage Specialty Store,
141 = Grocery,
142 = Specialty Food Store,
143 = Wine and Liquor,
144 = Bakery and Baked Goods Store,
145 = Sweet Shop,
146 = Butcher,
147 = Dairy Goods,
148 = Drug-Pharmacy,
149 = Drug Store,
150 = Pharmacy,
151 = Consumer Electronics Store,
152 = Mobile Retailer,
153 = Mobile Service Center,
154 = Computer and Software,
155 = Entertainment Electronics,
156 = Electronics,
157 = Hardware, House and Garden,
158 = Home Improvement-Hardware Store,
159 = Home Specialty Store,
160 = Floor and Carpet,
161 = Furniture Store,
162 = Garden Center,
163 = Glass and Window,
164 = Lumber,
165 = Major Appliance,
166 = Power Equipment Dealer,
167 = Paint Store,
168 = Other Bookshop,
169 = Book Store,
170 = Clothing and Accessories,
171 = Men's Apparel,
172 = Women's Apparel,
173 = Children's Apparel,
174 = Shoes-Footwear,
175 = Specialty Clothing Store,
176 = Consumer Goods,
177 = Sporting Goods Store,
178 = Office Supply and Services Store,
179 = Specialty Store,
180 = Pet Supply,
181 = Warehouse-Wholesale Store,
182 = General Merchandise,
183 = Discount Store,
184 = Flowers and Jewelry,
185 = Variety Store,
186 = Gift, Antique and Art,
187 = Hair and Beauty,
188 = Record, CD and Video,
189 = Video and Game Rental,
190 = Bicycle and Bicycle Accessories Shop,
191 = Market,
192 = Motorcycle Accessories,
193 = Non-Store Retailers,
194 = Pawnshop,
195 = Used-Second Hand Merchandise Stores,
196 = Adult Shop,
197 = Arts and Crafts Supplies,
198 = Florist,
199 = Jeweler,
200 = Toy Store,
201 = Bank,
202 = ATM,
203 = Money Transferring Service,
204 = Check Cashing Service-Currency Exchange,
205 = Communication-Media,
206 = Telephone Service,
207 = Commerical Services,
208 = Advertising-Marketing, PR and Market Research,
209 = Catering and Other Food Services,
210 = Construction,
211 = Customer Care-Service Center,
212 = Engineering and Scientific Services,
213 = Farming,
214 = Food Production,
215 = Human Resources and Recruiting Services,
216 = Investigation Services,
217 = IT and Office Equipment Services,
218 = Landscaping Services,
219 = Locksmiths and Security Systems Services,
220 = Management and Consulting Services,
221 = Manufacturing,
222 = Mining,
223 = Modeling Agencies,
224 = Motorcycle Service and Maintenance,
225 = Organizations and Societies,
226 = Entertainment and Recreation,
227 = Finance and Insurance,
228 = Healthcare and Healthcare Support Services,
229 = Real Estate and Brokers,
230 = Rental and Leasing,
231 = Repair and Maintenance Services,
232 = Printing and Publishing,
233 = Specialty Trade Contractors,
234 = Towing Service,
235 = Translation and Interpretation Services,
236 = Apartment Rental-Flat Rental,
237 = B2B Sales and Services,
238 = B2B Restaurant Services,
239 = Aviation,
240 = Interior and Exterior Design,
241 = Property Management,
242 = Financial Investment Firm,
243 = Business Facility,
244 = Police Station,
245 = Police Services-Security,
246 = Fire Department,
247 = Ambulance Services,
248 = Consumer Services,
249 = Travel Agent-Ticketing,
250 = Dry Cleaning and Laundry,
251 = Attorney,
252 = Banquet Hall,
253 = Boating,
254 = Business Service,
255 = Funeral Director,
256 = Mover,
257 = Photography,
258 = Realtor,
259 = Repair Service,
260 = Social Service,
261 = Storage,
262 = Tailor and Alteration,
263 = Tax Service,
264 = Utilities,
265 = Waste and Sanitary,
266 = Bicycle Service and Maintenance,
267 = Bill Payment Service,
268 = Body Piercing and Tattoos,
269 = Wedding Services and Bridal Studio,
270 = Internet Cafe,
271 = Kindergarten and Childcare,
272 = Maid Services,
273 = Marriage and Match Making Services,
274 = Public Administration,
275 = Misc. Consumer Services,
276 = Self Service Kiosk,
277 = Wellness Center and Services,
278 = Pet Care,
279 = Legal Services,
280 = Tanning Salon,
281 = Recycling Center,
282 = Electrical,
283 = Plumbing,
284 = Post Office,
285 = Post Box,
286 = Tourist Information,
287 = Fueling Station,
288 = Petrol-Gasoline Station,
289 = EV Charging Station,
290 = Automobile Dealership-New Cars,
291 = Automobile Dealership-Used Cars,
292 = Motorcycle Dealership,
293 = Car Repair-Service,
294 = Car Wash-Detailing,
295 = Car Repair,
296 = Auto Parts,
297 = Emission Testing,
298 = Tire Repair,
299 = Truck Repair,
300 = Van Repair,
301 = Road Assistance,
302 = Automobile Club,
303 = Rental Car Agency,
304 = Truck-Semi Dealer-Services,
305 = Truck Dealership,
306 = Truck Parking,
307 = Truck Stop-Plaza,
308 = Truck Wash,
309 = Hospital or Health Care Facility,
310 = Dentist-Dental Office,
311 = Family-General Practice Physicians,
312 = Psychiatric Institute,
313 = Nursing Home,
314 = Medical Services-Clinics,
315 = Hospital,
316 = Optical,
317 = Veterinarian,
318 = Hospital Emergency Room,
319 = Therapist,
320 = Chiropractor,
321 = Blood Bank,
322 = Government or Community Facility,
323 = City Hall,
324 = Embassy,
325 = Military Base,
326 = County Council,
327 = Civic-Community Center,
328 = Court House,
329 = Government Office,
330 = Border Crossing,
331 = Agricultural Checkpoint,
332 = Military Checkpoint,
333 = Education Facility,
334 = Higher Education,
335 = School,
336 = Training and Development,
337 = Coaching Institute,
338 = Fine Arts,
339 = Language Studies,
340 = Other Library,
341 = Library,
342 = Fair and Convention Facility,
343 = Convention-Exhibition Center,
344 = Parking Facility,
345 = Parking Garage-Parking House,
346 = Parking Lot,
347 = Park and Ride,
348 = Cellphone Parking Lot,
349 = Sports Facility-Venue,
350 = Sports Complex-Stadium,
351 = Ice Skating Rink,
352 = Swimming Pool,
353 = Tennis Court,
354 = Bowling Center,
355 = Indoor Ski,
356 = Hockey,
357 = Racquetball Court,
358 = Shooting Range,
359 = Soccer Club,
360 = Squash Court,
361 = Fitness-Health Club,
362 = Indoor Sports,
363 = Golf Course,
364 = Golf Practice Range,
365 = Race Track,
366 = Sporting Instruction and Camps,
367 = Sports Activities,
368 = Basketball,
369 = Badminton,
370 = Rugby,
371 = Diving Center,
372 = Facilities,
373 = Cemetery,
374 = Crematorium,
375 = Public Restroom-Toilets,
376 = Clubhouse,
377 = Offices,
378 = Registration Office,
379 = Hamlet,
380 = Named Place,
381 = Neighborhood,
382 = Outdoor Area-Complex,
383 = Industrial Zone,
384 = Marina,
385 = RV Parks,
386 = Collective Community,
387 = Island,
388 = Residential Area-Building,
389 = Business Area