Learn about Data Input format and type for Locations
Introduction
This article explains the data type and format for Location data. This includes Location and Content List data. The article is limited to the data format and types of data fields in the import/export file.
Scope
Direction Local has a set of rules that limit the input format of certain data fields. This is to ensure consistency in the data input process and to make sure that the data flow and submission to directories is smooth. The formatting rules mostly apply to the API and the import/export file, since this data is text-based. However, some format rules also apply to the user interface portion of the platform. Most of the format-heavy fields will be handled through dropdown lists or another piece of selectable element.
Locations
Field Name
Description
Format/Type
Example
business Identifier
Unique identifier to the Sales Partner defining a specific Business.
String
Mybusiness-1
identifier
Unique identifier to the Business defining a specific Location.
String
12345; Washington-1
status
Used to define a Location’s status
one of ACTIVE, INACTIVE, CLOSED
ACTIVE
name
Official name of the Location
String
John’s Pastries
streetAndNumber
Street name and civic number of the Location
String
Washington Blvd. 145
zip
If the country of your Location supports zip or postal codes, else leave empty
String
H3B 2S2; 13355
city
City your Location is located in. Make sure the zip code is in that city
String
San Francisco; Miami
country
Country your Location is located in
String – ISO 2-letter ASCII code
DE; US; CA; FR
lat
Latitude value for the Location
Double
51.9577024
lng
Longitude value for the Location
Double
7.37567411
categories
Business categories associated to your Location
Semicolon separated category IDs
1217;998;91
addressExtra
Address line 2 for your Location
String
suite 2; 101
phone
Main phone number to reach your Location
String
+49 8151 33333; +1 555 555 5555
fax
Fax number for your Location
String
+49 8151 33333; +1 555 555 5555
cellphone
Cell phone number to reach your Location
String
+49 8151 33333; +1 555 555 5555
website
Website of your Location
String
https://www.mywesbite.com
websiteExtra
Secondary website for your Location
String
https://www.mywesbite.com
descriptionShort
A short version of your Location’s Description
String – maximum 200 characters
A short description about who you are and what your business does (include keywords)
descriptionLong
The full version of your Location’s Description
String – maximum 1,000 characters
A 1,000 character description about who your company is, and all the services/products you provide.
openingHours
Your Location’s regular opening hours
String (Direction Local hours format – Maximum 2 sets of hours in a single day) The absence of a day of the week will mark that day as closed
Tu=10:00-18:00; We=10:00-18:00; Th=10:00-18:00; Fr=10:00-18:00; Sa=10:00-18:00
Special Opening Hours
Your Location’s special/holiday hours
String
2020-08-10=10:00-18:00; 2020-08-11=10:00-18:00; 2020-08-12=10:00-18:00; 2020-08-13=11:00-19:00; 2020-08-14=11:00-19:00; 2020-08-15=10:00-17:00; 2020-08-16=11:00-17:00; 2020-08-17=10:00-18:00; 2020-08-18=10:00-18:00; 2020-08-19=10:00-18:00; 2020-08-20=11:00-19:00; 2020-08-21=11:00-19:00
Opening Hours Notes
Extra description for your Location’s regular opening hours
String – maximum 255 characters
Talk about your business hours.
keywords
Keywords used to categorize your Location during searches
Comma separated Strings – maximum 20 keywords
Advertising, Customer Feedback,Directories, Listings, Local, Marketing, Online Presence Management, SEO
%MCEPASTEBIN%
logo
Logo representing your Location
Direct Url to the photo – JPG or PNG format. No transparent background. Maximum size of 5MB
squaredLogo
A squared version of your Logo
Direct Url to the photo – JPG or PNG format. No transparent background. Maximum size of 5MB
photo
Photos that represent your Location
Direct Urls to the photos (semicolon separated) – JPEG or PNG format. No logo. Minimum of 480px x 480px. Maximum size of 5MB
landscape
A landscape-style photo representing your Location
Direct Url to the photo – JPEG or PNG format. At least 480px in height. A 16:9 aspect ratio is recommended
brands
A list of product brands your Location carries
Comma separated Strings
Direction SEO, Direction Local, SEO Consulting
languages
Languages of service offered at your Location
Comma separated Strings
Spanish, English
services
Services offered at your Location
Comma separated Strings
Catering, In-house chef
Payment Options
Supported payment methods at your Location
Comma separated Strings
AMAZON, AMEX, APPLEPAY, CASH, CASH ONLY, CHECK, CHINAUNIONPAY, DEBIT, MASTERCARD, NFC
adminOnlyLabels
Supported payment methods at your Location
Comma separated Strings
AMAZON, AMEX, APPLEPAY, CASH, CASH ONLY, CHECK, CHINAUNIONPAY, DEBIT, MASTERCARD, NFC
publicLabels
Labels to apply publicly to your Location
Comma separated Strings
Grocery, public
imprint
A statement of ownership for web channels (only published to Facebook)
String – maximum 2000 characters
addressDisplay
Determines if your Location servers customers at a specific address
Boolean – false if Service Area Business
true; false
autoSync
Enable or Disable auto updates to Directories
Boolean
true; false
skipFacebookPicturesUpdate
Enable or Disable updating pictures on Facebook
Boolean
true; false
attributes
Google attributes for your Location. Attributes can only be used from the availableAttributes
Semicolon separated String (special format, see example)
“accepts_reservations”=”true”; “has_all_you_can_eat_always”=”true”; “has_bar_onsite”=”true”; “has_braille_menu”=”true”; “has_catering”=”true”; “has_childrens_menu”=”true”; “has_curbside_pickup”=”true”; “has_delivery”=”true”; “has_drive_through”=”true”; “has_fireplace”=”true”; “has_high_chairs”=”true”
