MetaLocator allows you to import a specially formatted field that is interpreted as a location's hours of operation. This information must be provided in the following format within your import file:
This information can also be provided as a single hours column in the following compact format:
An example of this format is as follows:
This example indicates that this location's hours of operation are
To use import multiple hours fields, the compact format must be used.
Times provided in your import file must use a 24 hour clock.
To indicate a location is open 24 hours a day, use 0:00-23:59
To indicate a closing time into the next day, such as opening at 6AM and closing at 2:30AM use this notation:
Multiple Hours Ranges Per Day
When a location has multiple open ranges to include, for example, a brief closure for lunch, additional ranges can be specified as shown below. The ranges are separated by a comma and should be provided in chronological order.
During bulk import, multiple hours ranges can be specified as above, or as repeated weekday columns as shown below:
To provide special hours for certain holidays, MetaLocator supports hours for specific days, or specific days of every year. For example, we support holiday hours that appear every year as shown below:
The above will show the location as open from 6 am to 7:30 pm on December 31st (New Year's Eve) every year, regardless of the day of week it falls upon. Holiday hours will always override the regular weekday hours. A more complete example might be as shown below:
The above example includes normal weekday hours and also indicates that the location is closed every year for New Year's Eve and this year will also be closed on Halloween (10-31). Since the hours specification includes the year, this same location would not show as closed on 10-31-2020. This allows our users to specify holiday hours once and not require updates every year for recurring holidays.
The Interface Builder can be used to add Hours display to your locator. Click Results, then expand the List group then click Add Field, choose Hours from the list of fields. The hours field has a series of Templates that control how it is displayed. The example below shows the "Collapse" template, which shows a summary of the location's hours today, (or next time open if closed) and current status, but also allows the user to expand and collapse to show the full location hours. Change the template to choose from other display options. Users with Pro and higher plans can access the template editor to completely customize location hours display.
Open, Closed and Closing Soon
The locationstatus field indicates the location's current "open" or "closed" status. When within 1 hour of closing, the system displays "closing soon". The open or closed status is based on the end user's local time zone as compared to the location's time zone. It will interpret the hours as local to the location, and the time as local to the user's browser.
The time zone is automatically populated during the geocoding process. If latitude and longitude are manually imported, the time zone should also be imported in the time_zone field. Valid values are maintained by the IANA.
If you want to provide alternative labelling or translations for the the weekday column headings, import your content using constants, such as
Then provide translations in the appropriate language file for
LOCATOR_MON and similar constants.
To translate "Open" and "Closed", provide translations for
LOCATOR_CLOSED . To provide a translation for the "Closed" label used in the weekday column, use
The language constant displayed for 24 hours locations is LOCATOR_HOURS_ALL_DAY .