Search for content

Places

The Places overlay visualizes points of interest (POIs) on the map. Each place is represented by an icon indicating its category, such as restaurants, hotels, fueling stations, or parking facilities. The data covers a wide range of place categories relevant to logistics and transportation use cases.

 

API endpoint

You need the following API endpoint to request places:

https://api.myptv.com/maps/overlays/v1/vector-tiles/

Request

For a single tile showing Karlsruhe, Germany specify the map tile path with zoomLevel, x and y as shown below. 

You can test this by entering the URL into your web browser. Be sure to replace YOUR_API_KEY with your actual API key.

https://api.myptv.com/maps/overlays/v1/vector-tiles/11/1072/703?layers=places&apiKey=YOUR_API_KEY

Get your free API Access Key

Response

The call result is a single map tile in MapBox Vector Tiles format.

Tile content

The requested vector tile contains data which is listed in this table. The individual columns are explained below.

Name of contentTypeDescription
geometrySRID 3857 The geographic point position (rooftop location) of the place in SRID 3857.
cattextA string containing one or more category codes separated by delimiters. Categories follow the HERE LCMS (Location Content Management System) place category scheme. A single place can belong to multiple categories.
nametextThe name of the place in the local default language.
name_transtextA transliteration of the place name into Latin script. Only available when the local name is in a non-Latin script. If the local name is already in Latin script, this field is null.

Place categories

Categories follow the HERE LCMS place category system. The cat property contains category codes in the format Level1-Level2 or Level1-Level2-Level3.

The following table lists all categories that have a dedicated style configuration in the PTV styles. Each entry has its own icon and layer definition.

 

100 - Eat and Drink

Category CodeNameDescriptionIcon
100-1000RestaurantAn establishment that prepares and serves refreshments and prepared meals.Restaurant
100-1100Coffee-TeaAn establishment that sells drinks, such as coffee and tea, as well as refreshments.

 

200 - Going Out-Entertainment

Category CodeNameDescriptionIcon
200-2000Nightlife-EntertainmentAn establishment that provides evening entertainment and usually serves alcoholic beverages.
200-2100CinemaAn establishment that shows movies through screen projection.
200-2200Theatre, Music and CultureAn establishment where various types of performing arts are presented.
200-2300Gambling-Lottery-BettingAn establishment that provides gambling entertainment.

 

300 - Sights and Museums

Category CodeNameDescriptionIcon
300-3000Landmark-AttractionA designated area of special interest to tourists.
300-3100MuseumAn establishment dedicated to the preservation and exhibition of artistic, historical, or scientific artifacts.
300-3200Religious PlaceAn establishment of special religious significance or where religious services are held.

 

350 - Natural and Geographical

Category CodeNameDescriptionIcon
350-3500Body of WaterA natural feature covered with water, such as a lake, river, or ocean.
350-3510Mountain or HillA natural feature that is higher than the surrounding land.
350-3520Undersea FeatureA natural or artificial feature that is below sea level.
350-3522Forest, Heath or Other VegetationA dense growth of trees, open uncultivated land, or other large masses of vegetation.
350-3550Natural and GeographicalA feature not classified as other natural or geographic categories.

 

400 - Transport

Category CodeNameDescriptionIcon
400-4000AirportA designated area for the landing and takeoff of aircraft.
400-4100-0035Train StationA hub for travelers along a railway network.
400-4100-0036Bus StationA facility that serves as a hub for inter-city bus service.
400-4100-0037Underground Train-SubwayA facility that provides access to an underground rail transit system.

 

400-4100-0038Commuter Rail StationA facility that provides access to regional or intra-city rail transportation.
400-4100-0039Commuter TrainA facility that provides access to above-ground rail transit systems.
400-4100-0040Public Transit AccessAn entrance or exit to public transit service.
400-4100-0041Transportation ServiceAn establishment that provides charter air travel, limousine, or taxi services.
400-4100-0042Bus StopLocation offering access to intercity and urban public transit lines.
400-4100-0043Local TransitA facility providing access to local transportation through buses, subways, and elevated trains.
400-4100-0044Ferry TerminalA terminal providing ferry services for passengers and vehicles by water.
400-4100-0045Boat FerryA terminal providing access to boat ferry services.
400-4100-0046Rail FerryA terminal providing access to rail ferry services.
400-4100-0047Taxi StandA designated queuing, loading, and unloading area for taxis.
400-4100-0051Rideshare PickupA designated area for the pickup of passengers by a rideshare driver.
400-4100-0225Highway EntranceAn entrance along a motorway, preceding an entrance ramp.
400-4100-0226Highway ExitA marked ramp or spur providing egress from a motorway.
400-4100-0326TollboothA structure along a motorway where a fee is paid for roadway usage.
400-4100-0337LightrailRail trolleys and streetcar lines (Tram).
400-4100-0338Water TransitBoat systems that provide transit service within an urban area.
400-4100-0339MonorailRail systems that operate on a single beam.
400-4100-0340Aerial TramwayPassenger vehicles suspended from aerial cables (e.g., teleferic).
400-4100-0341Bus Rapid TransitBus systems with dedicated bus ways or HOV lanes.
400-4100-0342Inclined RailFunicular-type vehicles operating on slopes via a cable mechanism.
400-4100-0347Bicycle Sharing LocationA designated area providing self-service docking stations for bicycles.
400-4100-0348Bicycle ParkingA designated area for parking bicycles.
400-4200-0048Weigh StationA facility providing weight services to ensure vehicles are compliant with regulations.
400-4200-0049Cargo CenterA facility where cargo is transferred between different modes of transportation.
400-4200-0050Rail YardA hub for freight trains where cargo is transferred.
400-4200-0051Seaport-HarbourA port where cargo ships dock to transfer cargo/freight.
400-4200-0052Airport CargoAn airport facility where cargo/freight is transferred.
400-4200-0240CouriersA facility providing air, land, or combined mode courier and express delivery services.
400-4200-0241Cargo TransportationA facility providing logistical support services (e.g., freight forwarders).
400-4200-0311Delivery EntranceA designated building entrance for deliveries.
400-4200-0312Loading DockA designated area where deliverers can load or unload cargo/freight.
400-4200-0313Loading ZoneA designated area where delivery vehicles may park to load or unload.
400-4300-0000Rest AreaAn establishment along a motorway providing restrooms and parking.
400-4300-0199Complete Rest AreaA rest area with restroom facilities, parking, snacks, and open space.
400-4300-0200Parking and Restroom Only Rest AreaAn area providing both parking and restrooms.

 

400-4300-0201Parking Only Rest AreaAn area providing only parking without other facilities.
400-4300-0202Motorway Service Rest AreaAn area adjacent to a motorway for refueling, rest, and refreshments.
400-4300-0251Roadside StationA roadside facility certified by Japan's MLIT with restaurants, shops, and restrooms.
400-4300-0308Scenic Overlook Rest AreaAn area along a roadway providing a place for drivers to observe the scenery.

 

500 - Accommodations

Category CodeNameDescriptionIcon
500-5000Hotel-MotelA business that provides lodging or temporary living quarters.
500-5100LodgingA business providing lodging to the public generally without room service.

 

550 - Leisure and Outdoor

Category CodeNameDescriptionIcon
550-5510Outdoor-RecreationPublic land preserved and maintained for recreational use.
550-5520LeisureA park containing rides and/or other entertainment.

 

600 - Shopping

Category CodeNameDescriptionIcon
600-6000Convenience StoreAn establishment selling groceries, toiletries, soft drinks, and other products.
600-6100Mall-Shopping ComplexA complex of businesses that are co-located and share common services.
600-6200Department StoreA business selling a wide variety of merchandise organized by department.
600-6300Food and DrinkA business selling specialty products of a particular type of food or beverage.
600-6400Drugstore or PharmacyA business selling medications, toiletry items, and other retail cosmetics.
600-6500ElectronicsA business selling consumer electronics and entertainment equipment.
600-6600Hardware, House and GardenA business selling crafts, gardening, remodeling, or decorating items for the home.
600-6700BookstoreA business selling books, magazines, and other reading material.
600-6800Clothing and AccessoriesA business selling apparel items, garments, or fashion accessories.
600-6900Consumer GoodsA business selling a variety of products targeted to consumers.
600-6950Hair and BeautyA business providing hair styling and personal appearance services.

 

700 - Business and Services

Category CodeNameDescriptionIcon
700-7000BankingA business specializing in maintenance, lending, exchange, or issuance of money.
700-7010ATMA computer terminal providing the ability to deposit, withdraw, or transfer funds.
700-7050Money-Cash ServicesA business providing money transferring or currency exchange services.
700-7100Communication-MediaA business providing communication services.
700-7200Commercial ServicesA business providing a service or product for use by other businesses.
700-7250Business-IndustryA business establishment that employs people in the local area.
700-7300Police-Fire-EmergencyMunicipal emergency services.
700-7400Consumer ServicesAn organization providing consumer services for a variety of products.
700-7450Post OfficeAn office that receives, sorts, dispatches, and delivers mail.
700-7460Tourist InformationA business providing information for visiting tourists.
700-7600Fueling StationA business that sells fuel for vehicles.
700-7600-0322EV Charging Station (Cars)A charging station providing recharging services for electric passenger cars.
700-7600-0323EV Charging Station (Trucks)A charging station providing recharging services for trucks and buses.
700-7600-0324EV Charging Station (2-wheelers)A charging station for two-wheelers and light electric vehicles.
700-7600-0325EV Battery Swap StationA location where an EV battery can be exchanged for a fully charged one.
700-7800Car Dealer-SalesA business selling new automobiles and motorcycles.
700-7850Car Repair-ServiceA business providing automotive repair services.
700-7851Car RentalA business renting or leasing automobiles.
700-7900Truck-Semi Dealer-ServicesA business selling or servicing trucks and tractor trailers.
700-7900-0131Truck ParkingA designated area for parking heavy trucks/lorries.

 

800 - Facilities

Category CodeNameDescriptionIcon
800-8000Hospital or Health Care FacilityAn institution providing medical or surgical treatment for the sick or injured.
800-8100Government or Community FacilityA place where government services are provided.
800-8100-0172Border CrossingA controlled junction where travellers or goods are inspected upon entry or exit.
800-8200Education FacilityAn institution providing post-secondary or tertiary education.
800-8250SchoolAn institution providing basic or secondary education.
800-8300LibraryA facility offering books, periodicals, audio, video, and other material for public use.
800-8400Event SpacesA facility providing space for large events such as trade shows or conventions.
800-8500ParkingAn area or building used for parking motor vehicles.
800-8600Sports Facility-VenueA facility where sporting events are held.
800-8700FacilitiesA structure serving a specific function, activity, or service.

 

900 - Areas and Buildings

Category CodeNameDescriptionIcon
900-9100City, Town or VillageA named settlement that may be a city, town, or village.
900-9200Outdoor Area-ComplexAn outdoor area or complex with designations for specific businesses or interests.
900-9300BuildingA plot of land or building designated for residential or office use.
900-9400Administrative Region-StreetsAn administrative region, such as a postal area, or a named street/square/intersection.

 

Zoom level behavior

The overlay applies a progressive disclosure approach based on zoom level.
More important or logistically relevant categories appear at lower zoom levels, while the full set of categories becomes visible at higher zoom levels.

Zoom LevelBehavior 
10–12Only transport-related categories (400-4xxx) and border crossings (800-8100-0172) are shown.
12–13Additionally includes police/fire/emergency (700-7300) and truck parking (700-7900-0131).
13–15Broader set including fueling stations, hotels, parking, EV charging, car services, truck stops, and more.
15+ Full set of all categories with multi-language name support. 

 

Styling

Places are shown as icons.

 

Layer names

Our predefined layer styles have a recurring naming scheme. All places layer start with Places_.

 

How to implement

The tutorial on how to integrate overlays into a Vector Map also addresses places.