Package com.here.sdk.search

Class PlaceCategory

java.lang.Object
com.here.NativeBase
com.here.sdk.search.PlaceCategory
public final class PlaceCategory extends NativeBase

Represents a category of place with different levels of granularity. This class also defines a set of most commonly used categories.

  • Field Details

    • EAT_AND_DRINK

      public static final String EAT_AND_DRINK

      Top level category for places where food or beverages are prepared or served.

      See Also:

    • EAT_AND_DRINK_RESTAURANT

      public static final String EAT_AND_DRINK_RESTAURANT

      An establishment that prepares and serves refreshments and prepared meals.

      See Also:

    • EAT_AND_DRINK_COFFEE_TEA

      public static final String EAT_AND_DRINK_COFFEE_TEA

      An establishment that sells drinks, such as coffee and tea, as well as refreshments.

      See Also:

    • GOING_OUT_ENTERTAINMENT

      public static final String GOING_OUT_ENTERTAINMENT

      Top level category for places commonly associated with entertainment, such as bars, cinemas, theatres, casinos and night clubs.

      See Also:

    • GOING_OUT_NIGHTLIFE

      public static final String GOING_OUT_NIGHTLIFE

      An establishment that provides evening entertainment and usually serves alcoholic beverages.

      See Also:

    • GOING_OUT_CINEMA

      public static final String GOING_OUT_CINEMA

      An establishment that shows movies through screen projection.

      See Also:

    • GOING_OUT_THEATRE_MUSIC_CULTURE

      public static final String GOING_OUT_THEATRE_MUSIC_CULTURE

      An establishment where various types of performing arts are presented.

      See Also:

    • GOING_OUT_GAMBLING_LOTTERY_BETTING

      public static final String GOING_OUT_GAMBLING_LOTTERY_BETTING

      An establishment that provides gambling entertainment.

      See Also:

    • SIGHTS_AND_MUSEUMS

      public static final String SIGHTS_AND_MUSEUMS

      Top level category for places of special interest, such as common tourist attractions, museums and places of worship.

      See Also:

    • SIGHTS_LANDMARK_ATTACTION

      @Deprecated public static final String SIGHTS_LANDMARK_ATTACTION
      Deprecated.

      Will be removed in v4.26.0. Please use SIGHTS_LANDMARK_ATTRACTION instead.

      A designated area of special interest to tourists.

      See Also:

    • SIGHTS_LANDMARK_ATTRACTION

      public static final String SIGHTS_LANDMARK_ATTRACTION

      A designated area of special interest to tourists.

      See Also:

    • SIGHTS_MUSEUM

      public static final String SIGHTS_MUSEUM

      An establishment dedicated to the preservation and exhibition of artistic, historical, or scientific artifacts.

      See Also:

    • SIGHTS_RELIGIOUS_PLACE

      public static final String SIGHTS_RELIGIOUS_PLACE

      An establishment special religious significance or where religious services are held.

      See Also:

    • NATURAL_AND_GEOGRAPHICAL

      public static final String NATURAL_AND_GEOGRAPHICAL

      Top level category for natural or man-made areas of regional importance, such as bodies of water, mountains, forested areas and other geographic areas.

      See Also:

    • NATURAL_AND_GEOGRAPHICAL_BODY_OF_WATER

      public static final String NATURAL_AND_GEOGRAPHICAL_BODY_OF_WATER

      A natural and geographical feature of the earth's surface that is covered with water, such as a lake, river, stream or ocean.

      See Also:

    • NATURAL_AND_GEOGRAPHICAL_MOUNTAIN_OR_HILL

      public static final String NATURAL_AND_GEOGRAPHICAL_MOUNTAIN_OR_HILL

      A natural and geographical feature that is higher than the surrounding land.

      See Also:

    • NATURAL_AND_GEOGRAPHICAL_UNDERSEA_FEATURE

      public static final String NATURAL_AND_GEOGRAPHICAL_UNDERSEA_FEATURE

      A natural or artificial feature that is below sea level.

      See Also:

    • NATURAL_AND_GEOGRAPHICAL_FOREST_HEALTH_OTHER_VEGETATION

      public static final String NATURAL_AND_GEOGRAPHICAL_FOREST_HEALTH_OTHER_VEGETATION

      A dense growth of trees, open uncultivated land or other large masses of vegetation.

      See Also:

    • NATURAL_AND_GEOGRAPHICAL_OTHER

      public static final String NATURAL_AND_GEOGRAPHICAL_OTHER

      A feature not classified as a Body of Water, Mountain or Hill, Undersea Feature, or Forest, Heath or Other Vegetation.

      See Also:

    • TRANSPORT

      public static final String TRANSPORT

      Top level category for places commonly associated with pedestrian and cargo transport facilities, including airports, rail yards and seaports.

      See Also:

    • TRANSPORT_AIRPORT

      public static final String TRANSPORT_AIRPORT

      A designated area that serves various aspects of aviation related sports, including gliders, recreational aircraft and model airplanes.

      See Also:

    • TRANSPORT_PUBLIC

      public static final String TRANSPORT_PUBLIC

      A facility for travelers who are travelling between stops on public transport.

      See Also:

    • TRANSPORT_CARGO

      public static final String TRANSPORT_CARGO

      A facility that handles some aspect of the transportation of cargo freight.

      See Also:

    • TRANSPORT_REST_AREA

      public static final String TRANSPORT_REST_AREA

      An establishment along a motorway (controlled access road) that provides restrooms and parking.

      See Also:

    • ACCOMMODATION

      public static final String ACCOMMODATION

      Top level category for places offering lodging accommodations, dwellings or similar living quarters to travellers, such as hotels, motels, resorts, cruise ships and campgrounds.

      See Also:

    • ACCOMMODATION_HOTEL_MOTEL

      public static final String ACCOMMODATION_HOTEL_MOTEL

      A business that provides lodging or temporary living quarters.

      See Also:

    • ACCOMMODATION_LODGING

      public static final String ACCOMMODATION_LODGING

      A business that provides lodging to the public generally without room service.

      See Also:

    • LEISURE_AND_OUTDOOR

      public static final String LEISURE_AND_OUTDOOR

      Top level category for places that are designated for sports, recreation, parking, beaches and other leisure and outdoor activities.

      See Also:

    • LEISURE_OUTDOOR_RECREATION

      public static final String LEISURE_OUTDOOR_RECREATION

      Public land preserved and maintained for recreational use.

      See Also:

    • LEISURE_OTHER

      public static final String LEISURE_OTHER

      A park that contains rides and/or other entertainment which may be based on a central theme.

      See Also:

    • SHOPPING

      public static final String SHOPPING

      Top level category for places where consumer goods are commonly sold, such as clothing stores, grocery stores, hardware stores and other types of shopping centers.

      See Also:

    • SHOPPING_CONVENIENCE_STORE

      public static final String SHOPPING_CONVENIENCE_STORE

      An establishment that sells groceries, candy, toiletries, soft drinks, tobacco products, newspapers and other products.

      See Also:

    • SHOPPING_MALL_COMPLEX

      public static final String SHOPPING_MALL_COMPLEX

      A complex of businesses that are co-located and share common services.

      See Also:

    • SHOPPING_DEPARTMENT_STORE

      public static final String SHOPPING_DEPARTMENT_STORE

      A business that sells a wide variety of merchandise that is organized by product or service departments.

      See Also:

    • SHOPPING_FOOD_AND_DRINK

      public static final String SHOPPING_FOOD_AND_DRINK

      A business that sells specialty products of a particular type of food or beverage.

      See Also:

    • SHOPPING_DRUGSTORE_PHARMACY

      public static final String SHOPPING_DRUGSTORE_PHARMACY

      A business that sells medications, toiletry items and other retail cosmetics.

      See Also:

    • SHOPPING_ELECTRONICS

      public static final String SHOPPING_ELECTRONICS

      A business that sells consumer electronics and electronic entertainment equipment.

      See Also:

    • SHOPPING_HARDWARE_HOUSE_GARDEN

      public static final String SHOPPING_HARDWARE_HOUSE_GARDEN

      A business that sells crafts, gardening, remodeling, or decorating items for the home.

      See Also:

    • SHOPPING_BOOKSTORE

      public static final String SHOPPING_BOOKSTORE

      A business that sells books, magazines and other reading material.

      See Also:

    • SHOPPING_CLOTHING_AND_ACCESORIES

      public static final String SHOPPING_CLOTHING_AND_ACCESORIES

      A business that sells apparel items, garments or fashion accessories for men, women, and children.

      See Also:

    • SHOPPING_CONSUMER_GOODS

      public static final String SHOPPING_CONSUMER_GOODS

      A business that sells a variety of products targeted to consumers.

      See Also:

    • SHOPPING_HAIR_AND_BEAUTY

      public static final String SHOPPING_HAIR_AND_BEAUTY

      A business that provides hair styling and personal appearance services. Places in this category may also sell hair products and other related cosmetic items.

      See Also:

    • BUSINESS_AND_SERVICES

      public static final String BUSINESS_AND_SERVICES

      Top level category for places that provide professional services to other businesses, such as printing, photocopying, graphic design, marketing, advertising and other general business services.

      See Also:

    • BUSINESS_AND_SERVICES_BANKING

      public static final String BUSINESS_AND_SERVICES_BANKING

      Businesses that specialize in the maintenance, lending, exchange, or issuance of money.

      See Also:

    • BUSINESS_AND_SERVICES_ATM

      public static final String BUSINESS_AND_SERVICES_ATM

      A computer terminal that allows bank customers to deposit, withdraw, or transfer funds without the assistance of a bank teller.

      See Also:

    • BUSINESS_AND_SERVICES_MONEY_CASH

      public static final String BUSINESS_AND_SERVICES_MONEY_CASH

      Businesses that provide money related services.

      See Also:

    • BUSINESS_AND_SERVICES_COMMUNICATION_MEDIA

      public static final String BUSINESS_AND_SERVICES_COMMUNICATION_MEDIA

      Businesses that provide communication services.

      See Also:

    • BUSINESS_AND_COMMERCIAL_SERVICES

      public static final String BUSINESS_AND_COMMERCIAL_SERVICES

      Businesses that provide a service or product for use by other businesses.

      See Also:

    • BUSINESS_AND_SERVICES_INDUSTRY

      public static final String BUSINESS_AND_SERVICES_INDUSTRY

      Businesses that employ people in and around the city in which it is located.

      See Also:

    • BUSINESS_AND_SERVICES_POLICE_FIRE_EMERGENCY

      public static final String BUSINESS_AND_SERVICES_POLICE_FIRE_EMERGENCY

      Municipal emergency services.

      See Also:

    • BUSINESS_AND_CONSUMER_SERVICES

      public static final String BUSINESS_AND_CONSUMER_SERVICES

      An organization that provides consumer services for a variety of products for used by the public.

      See Also:

    • BUSINESS_AND_SERVICES_POST_OFFICE

      public static final String BUSINESS_AND_SERVICES_POST_OFFICE

      An office or station that receives, sorts, dispatches and delivers mail to a specific area or region.

      See Also:

    • BUSINESS_AND_SERVICES_TOURIST_INFORMATION

      public static final String BUSINESS_AND_SERVICES_TOURIST_INFORMATION

      Businesses that provide a variety of information for visiting tourists, such as event schedules, lodging/accommodations, restaurants, attractions and more.

      See Also:

    • BUSINESS_AND_SERVICES_FUELING_STATION

      public static final String BUSINESS_AND_SERVICES_FUELING_STATION

      Businesses that sell fuel for vehicles, such as petrol, electricity etc.

      See Also:

    • BUSINESS_AND_SERVICES_PETROL_GASOLINE_STATION

      public static final String BUSINESS_AND_SERVICES_PETROL_GASOLINE_STATION

      Businesses that sell fuel, oil, and other motoring supplies.

      See Also:

    • BUSINESS_AND_SERVICES_EV_CHARGING_STATION

      public static final String BUSINESS_AND_SERVICES_EV_CHARGING_STATION

      Businesses that provide recharging services for electric vehicles.

      See Also:

    • BUSINESS_AND_SERVICES_CAR_DEALER_SALES

      public static final String BUSINESS_AND_SERVICES_CAR_DEALER_SALES

      Businesses that sell new automobiles and motorcycles.

      See Also:

    • BUSINESS_AND_SERVICES_CAR_REPAIR_SERVICES

      public static final String BUSINESS_AND_SERVICES_CAR_REPAIR_SERVICES

      Businesses that provide automotive repair services.

      See Also:

    • BUSINESS_AND_SERVICES_CAR_RENTAL

      public static final String BUSINESS_AND_SERVICES_CAR_RENTAL

      Businesses that rent or lease automobiles.

      See Also:

    • BUSINESS_AND_SERVICES_TRUCK_SEMI_DEALER

      public static final String BUSINESS_AND_SERVICES_TRUCK_SEMI_DEALER

      Business that sell or service trucks and tractor trailers.

      See Also:

    • FACILITIES

      public static final String FACILITIES

      Top level category for places associated with specialized facilities, such as sports venues, government buildings, health care centers and other types of facilities.

      See Also:

    • FACILITIES_HOSPITAL_HEALTHCARE

      public static final String FACILITIES_HOSPITAL_HEALTHCARE

      Facilities that include dental offices, hospitals, nursing homes and other health care-related services.

      See Also:

    • FACILITIES_GOVERNMENT_COMMUNITTY

      public static final String FACILITIES_GOVERNMENT_COMMUNITTY

      A Place where government services are provided.

      See Also:

    • FACILITIES_EDUCATION

      public static final String FACILITIES_EDUCATION

      Facilities that are used for educational purposes including training, coaching, universities and more.

      See Also:

    • FACILITIES_SCHOOL

      public static final String FACILITIES_SCHOOL

      Educational facilities that include primary schools, secondary schools and more.

      See Also:

    • FACILITIES_LIBRARY

      public static final String FACILITIES_LIBRARY

      Facilities that offer books, periodicals, audio, video and other material for public use.

      See Also:

    • FACILITIES_EVENT_SPACES

      public static final String FACILITIES_EVENT_SPACES

      An area or facility used for the hosting of fairs and conventions.

      See Also:

    • FACILITIES_PARKING

      public static final String FACILITIES_PARKING

      Area or building used for parking cars.

      See Also:

    • FACILITIES_VENUE_SPORTS

      public static final String FACILITIES_VENUE_SPORTS

      A facility used for individual and team sports including recreational sports.

      See Also:

    • FACILITIES_OTHER

      public static final String FACILITIES_OTHER

      Facilities with miscellaneous uses such as Clubhouses, Offices, and Registration Offices.

      See Also:

    • AREAS_AND_BUILDINGS

      public static final String AREAS_AND_BUILDINGS

      Top level category for places that are owned, operated or managed by municipalities, such as cities, towns, villages, boroughs and shires.

      See Also:

    • AREAS_AND_BUILDINGS_OUTDOOR_COMPLEX

      public static final String AREAS_AND_BUILDINGS_OUTDOOR_COMPLEX

      Outdoor areas or complexes with designations for specific businesses or interests.

      See Also:

    • AREAS_AND_BUILDINGS_RESIDENTAL_OFFICE

      public static final String AREAS_AND_BUILDINGS_RESIDENTAL_OFFICE

      Areas and buildings designated for residential or office use.

      See Also:

  • Constructor Details

    • PlaceCategory

      public PlaceCategory(@NonNull String id)

      Creates a new instance of this class.

      Parameters:
      id -

      Place category ID. The HERE places category system provides three levels of granularity:

      1. Level 1 represents high level groupings, such as "Eat and drink". Their IDs take the form "xxx", for example "100".
      2. Level 2 represents logical sub-groups or domains, such as "Eat and Drink / Restaurant". Their IDs take the form "xxx-xxxx", for example "100-1000".
      3. Level 3 provides the greatest level of granularity about place categorization, such as "Eat and Drink / Restaurant / Casual Dining". Their IDs take the form "xxx-xxxx-xxxx", for example "100-1000-0001". The category ID can be provided as one of the predefined values, such as EAT_AND_DRINK_RESTAURANT or as a literal string that matches one of the category IDs defined by the HERE Search service. Only level 1 and 2 category IDs are predefined. The complete list of supported category IDs, including level 3, can be found online: https://www.here.com/docs/bundle/geocoding-and-search-api-v7-api-reference/page/index.html.

  • Method Details

    • getId

      @NonNull public String getId()

      Gets the place category ID.

      Returns:

      Place category ID.

    • getName

      @Nullable public String getName()

      Gets the localised place category name.

      It is available only when when PlaceCategory is obtained from Place. That means that when PlaceCategory is constructed directly by the client, name is always null.

      Returns:

      Localised place category name.