The following figure illustrates an example of points of interest (POIs) rendered from the data.
Figure 1. Sample POIs in Madrid
The layer content is defined as follows.
Layer name: pois
Geometry types: point
POI Properties (common)
The following properties are used to define a POI.
name - Generally the name the locals call the feature, in the local language script.
id - An internal HERE ID or places id that can be used in other HERE Services to find additional information about the POI.
kind - POI types can be one of the options listed below.
min_zoom - This property contains a suggested minimum zoom at which the POI should become visible.
pds_category - A string property that matches the Category ID from the PDS category system. For possible pds_category values, see below.
elevation - Mountain peak height in meters, applicable only for kind peak.
POI Properties (common-optional)
kind_detail - POI subtypes that narrow down the kind value. For possible values, see below.
country - This property contains the ISO 3166-1 alpha-2 two-letter country code.
quality_score - hint of quality of the feature, integer value with 5 as a high quality value and 3 for lower quality records. Records with values 1 and 2 are not included.
has_national_importance - true for poi records with the highest importance, for example, international airports. There is no false value, as the property is not present in that case.
has_traffic_lights - true if it's an intersection with traffic lights. There is no false value, as the property is not present in that case. Available only for the traffic_signals kind.
root_id - an integer ID which can be used to group together a station and corresponding station entrances or exits. All features in one group will have the same root_id. Available only for the station and station_entrance kinds.
display_type - hint for rendering clients on how to preferably contextualize the POI. Property is only applicable for some regions of the world within the core layer parameter. For more information about the layer parameters available in the HERE Vector Tile API, see Layer Parameter. Possible values are: icon, icon_with_label, label, reduced_icon_with_label. POIs that have this property should be treated with higher priority than those lacking it.
POI Properties (Only on kind:station)
is_* - true only if this station has any transits of the given type. These are: is_train and those within the core layer parameter that correspond to transit kind_detail values, specifically is_speed_rail for high_speed, is_state_rail for intercity, is_private_rail for regional, is_subway for subway, is_suburban for suburban, is_tram for tram, is_monorail for monorail, is_funicular for funicular, and is_aerial for aerial. There is no false value, as the property is not present in that case.
is_multimodal - true only if this is a multimodal station, that is with more than one is_* property. There is no false value, as the property is not present in that case. For multimodal stations, the PDS category with the highest priority is used. For example, if a multimodal station has is_subway property with priority 83 and is_monorail property with priority 99, then pds_category would be 400-4100-0037. For multimodal station priorities, see below.
POI Properties (Only on kind:motorway_junction)
is_entry - true indicates a poi is an entry point to a ramp. There is no false value, as the property is not present in that case.
is_exit - true indicates a poi is an exit point from a ramp. There is no false value, as the property is not present in that case.
POI kind Values
administrative
adult_gaming_centre
advertising_agency
aerodrome with kind_detail property
airport
alcohol
ambulance_service
apartment_rental
aquarium
arts_centre
artwork
atm
attraction
autoclub
bakery
bank
beach_resort
beach
beauty
bed_and_breakfast
bicycle_parking
bicycle_rental_station
bicycle
biergarten
blood_bank
boat_rental
books
border_crossing
bowling_centre
brewery
building
bureau_de_change
bus_station
bus_stop
butcher
cafe
camp_site
car_parts
car_rental
car_repair
car_wash
car
caravan_site
casino
caterer
cemetery
childcare
chiropractor
clinic
clothes
clubhouse
coffee
college
community_centre
computer
confectionery
construction
consulting
consumer_service
convenience
copyshop
courthouse
craft with kind_detail property
crematorium
customer_centre
dairy_kitchen
dance
danger_area
deli
dentist
department_store
design
dive_centre
doityourself
educational_institution
electrician
electronics
embassy
emergency_phone
emission_testing
engineering_service
estate_agent
event_venue
farm
fashion
fast_food
ferry_terminal
financial
fitness
florist
food_production
forest
fuel
funeral_directors
furniture
gallery
gambling
garden_centre
garden
gardener
gift
golf_course
government
grocery
guest_house
hairdresser
hamlet
health_centre
healthcare_laboratory
healthcare
historical
hospital
hospital with kind_detail property
hostel
hotel
hunting
industrial
information
insurance
internet_cafe
intersection
island
it
jewelry
karaoke
landmark
laundry
lawyer
library
lottery
mall
marina
marketplace
matchmaking
meeting_point
military
mineshaft
mobile_phone
money_transfer
mooring
motel
motorcycle
motorway_junction
mover_service
museum
music
named_place
nature_reserve
neighborhood
nightclub
notary
nursing_home
office
offroad_vehicle_area
optician
outdoor_recreation
outdoor
park
parking_garage
parking with kind_detail property
peak
pet
petting_zoo
pharmacy
photo
physician
pitch with kind_detail property
place_of_worship with kind_detail property
plumber
police
post_office
private_investigator
psychotherapist
ranger_station
recreation_ground
recreation_track with kind_detail property
recruting
recycling
registration_office
rental
repair
reservoir
residential_home
resort
rest_area
restaurant
retail
road_assistance
rock
saddle
school
second_hand
settlement
shoemaker
shoes
shop with kind_detail property
ski_lift
social_facility
sports_centre
sports_centre with kind_detail property
sports
station_entrance
storage
store with kind_detail property
summer_camp
swimming_area
tailor
tax_advisor
taxi
telecommunication
telephone
theme_park
therapist
tobacco
toilets
towing_service
townhall
toys
trade with kind_detail property
traffic_signals
trailhead
translator
transportation_service
travel_agency
tyres
undersea
university
utility
variety_store
veterinary
video_rental
viewpoint
walking_junction
waste_disposal
water_park
waterfall
waterway
wedding_service
wildlife_park
wine
winery
winter_sports
zoo
POI kind Values for Certain Areas in core
The following list of kind values is only applicable for some regions of the world within the core layer parameter. For more information about the layer parameters available in the HERE Vector Tile API, see Layer Parameter.
Below are these kind values within the core layer parameter for Japan:
cargo_transportation
charging_station
courier
delivery_entrance
government with kind_detail property
harbour
intersection with kind_detail property
loading_zone
station_entrance - an entrance or exit to a transit station with root_id property
station with is_train property and one of is_speed_rail, is_state_rail, or is_private_rail properties for train stations; with is_suburban property for commuter rail stations; with is_tram property for light rails; with is_monorail property for monorails; with is_funicular property for inclined rails; with is_aerial property for aerial tramways; with is_subway property for subways; with is_multimodal property for multimodal stations; and with root_id property to relate with corresponding station entrances or exits.
toll_booth
weight_station
POI pds_category Values
Note
pds_category does not exactly correspond to kind, as, for example, a train station, commuter rail station, commuter train and subway all have the station kind, an amusement park has the theme_park kind, and a tourist attraction has the attraction kind.
100-1000-0000 - restaurant (restaurant kind)
100-1000-0001 - casual dining (restaurant kind)
100-1000-0002 - fine dining (fast_food kind)
100-1000-0003 - take out and delivery only (fast_food kind)
900-9100-0000 - city, town or village (settlement kind)
900-9100-0214 - hamlet (hamlet kind)
900-9100-0215 - named place (named_place kind)
900-9100-0216 - neighborhood (neighborhood kind)
900-9200-0000 - outdoor area or complex (outdoor kind)
900-9200-0218 - industrial zone (industrial kind)
900-9200-0219 - marina (marina kind)
900-9200-0220 - recreational vehicle (RV) parks (caravan_site kind)
900-9200-0299 - collective community (community_centre kind)
900-9200-0301 - island (island kind)
900-9200-0386 - meeting point (meeting_point kind)
900-9300-0000 - building (building kind)
900-9300-0221 - residential area or building (residential_home kind)
900-9400-0000 - administrative region or streets (administrative kind)
900-9400-0399 - administrative region (administrative kind)
900-9400-0400 - postal area (administrative kind)
900-9400-0401 - street or square (administrative kind)
POI kind_detail Values for Certain Areas in core
The following list of kind_detail values is only applicable for some regions of the world within the core layer parameter. For more information about the layer parameters available in the HERE Vector Tile API, see Layer Parameter.
Below are these kind_detail values within the core layer parameter for Japan:
For features of kind aerodrome:
gliding
For features of kind craft:
cleaning
distillery
For features of kind government:
prefectural_office
ward_office
town_village_office
For features of kind hospital:
emergency_room
For features of kind hotel:
hot_spring
For features of kind intersection:
junction
interchange
intersection
smart_interchange- an interchange that only allows vehicles with the electronic toll collection (ETC) smart tag installed to embark
toll_interchange
For features of kind parking:
cellphone_lot
park_ride
For features of kind pitch:
badminton
basketball
hockey
racquetball
rugby
soccer
squash
tennis
For features of kind recreation_track:
bmx
cycling
race_track
running
For features of kind shop:
adult
craft
ecigarette
lumber
major_appliance
media
pawnshop
security_service
speciality_clothing
speciality_food
sporting_goods
sports
For features of kind store:
floor
home_furnishing
paint
power_equipment
speciality
window
wholesale_store
For features of kind sports_centre:
ski
For features of kind place_of_worship:
buddhist
shinto
For features of kind trade:
aircraft
restaurant_supplies
POI pds_category Values for Certain Areas in core
The following list of pds_category values is only applicable for some regions of the world within the core layer parameter. For more information about the layer parameters available in the HERE Vector Tile API, see Layer Parameter.
Below are these pds_category values within the core layer parameter for Japan:
300-3200-0031 - temple (place_of_worship kind with buddhist kind_detail)
300-3200-0035 - shrine (place_of_worship kind with shinto kind_detail)
400-4100-0035 - train station (station kind with root_id, is_multimodal, is_train, and one of is_speed_rail, is_state_rail, or is_private_rail properties)
400-4100-0037 - subway (station kind with is_subway, root_id, and is_multimodal properties)
400-4100-0038 - commuter rail station (station kind with is_suburban and root_id, and is_multimodal properties)
400-4100-0040 - public transit access (station_entrance kind with root_id property)
400-4100-0326 - tollbooth (toll_booth kind)
400-4100-0337 - light rail (station kind with is_tram, root_id, and is_multimodal properties)
400-4100-0339 - monorail (station kind with is_monorail, root_id, and is_multimodal properties)
400-4100-0340 - aerial tramway (station kind with is_aerial, root_id, and is_multimodal properties)
400-4100-0342 - inclined rail (station kind with is_funicular, root_id, and is_multimodal properties)
400-4200-0048 - weigh station (weigh_station kind)
400-4200-0049 - cargo center (cargo_transportation kind)
700-7600-0322 - electric vehicle (EV) charging station (charging_station kind)
700-7600-0325 - electric vehicle (EV) battery swap station (charging_station kind)
700-7850-0126 - truck repair (car_repair kind)
700-7900-0000 - truck and semi-truck dealer or services (car kind)
700-7900-0130 - truck dealership (car kind)
700-7900-0131 - truck parking (parking kind)
700-7900-0132 - truck stop or plaza (parking kind)
700-7900-0323 - truck wash (car_wash kind)
800-8100-0171 - government office (government kind with one of prefectural_office, ward_office, town_village_office kind_detail)
900-9400-0402 - road intersection (intersection kind with one of intersection, interchange, smart_interchange, toll_interchange, junction kind_detail), road intersection with traffic lights (traffic_signals kind with has_traffic_lights property), or named intersection with traffic lights (traffic_signals kind with has_traffic_lights and name properties)
POI Multimodal Station Priorities for Certain Areas in core
The following list of pds_category priorities is only applicable for some regions of the world within the core layer parameter. For more information about the layer parameters available in the HERE Vector Tile API, see Layer Parameter.
Below are these pds_category priorities within the core layer parameter for Japan: | PDS Category | PDS Category Name | Priority | |:------------:|:-----------------:|----------| |400-4100-0035|Train Station|20| |400-4100-0037|Underground Train Subway|83| |400-4100-0038|Commuter Rail Station|86| |400-4100-0337|Light Rail|97| |400-4100-0339|Monorail|99| |400-4100-0340|Aerial Tramway|101| |400-4100-0342|Inclined Rail|103|