Opening hours
Opening hours
Represents information that states when a POI will be open during the next 7 days, starting with the current day in the local time of the POI. It returns a list of strings that represent the opening and closing hours in a given Response format.
Sample use case 1: You are searching for a specific store to visit but you don`t know if it is currently open. Through your app you query the opening shop times and the store working hours are displayed on the screen.
Sample use case 2: A company is collating a report about the closing hours in a given city area for grocery shops. Using the SDK services, all grocery shops in a given radius can be queried for closing hours, allowing statistical analysis and other studies.
The opening hours data are available in the Search API.
Have a look at the detailed documentation for more information related to the Points of Interest Search and Fuzzy Search
That parameter will be used for services where POIs are exposed, including:
-
Category Search
-
Along Route Search
-
Geometry Search
-
Fuzzy Search
Include "withOpeningHours" in the query builder as shown in the following code snippet:
_
TimeDescriptor timeDescriptor = new TimeDescriptor(OpeningHoursMode.NEXT_SEVEN_DAYS);
FuzzySearchEngineDescriptor fuzzySearchEngineDescriptor = new FuzzySearchEngineDescriptor.Builder()
.language("en-GB")
.build();
FuzzyLocationDescriptor fuzzyLocationDescriptor = new FuzzyLocationDescriptor.Builder()
.positionBias(new LatLngBias(Locations.AMSTERDAM_LOCATION))
.build();
FuzzySearchSpecification openingHoursSpecification = new FuzzySearchSpecification.Builder("Petrol station")
.searchEngineDescriptor(fuzzySearchEngineDescriptor)
.locationDescriptor(fuzzyLocationDescriptor)
.timeDescriptor(timeDescriptor)
.build();
searchAPI.search(openingHoursSpecification, fuzzyOutcomeCallback);
val timeDescriptor = TimeDescriptor(OpeningHoursMode.NEXT_SEVEN_DAYS)
val searchEngineDescriptor = FuzzySearchEngineDescriptor.Builder()
.language("en-GB")
.build()
val locationDescriptorBuilder = FuzzyLocationDescriptor.Builder()
.positionBias(LatLngBias(Locations.AMSTERDAM))
.build()
val openingHoursQuery = FuzzySearchSpecification.Builder("Petrol station")
.searchEngineDescriptor(searchEngineDescriptor)
.locationDescriptor(locationDescriptorBuilder)
.timeDescriptor(timeDescriptor)
.build()
Screenshots:
![]() Opening hours activated |