How to set up Star Maps
You can now use the Star Map feature.
The following article will guide you through the set up process of the Star Map feature.
Before we begin, it is required to connect your Mapbox or Google Map account too teeinblue first. This is needed so that you can use the location search function while using the Star Map feature. Visit this article for detailed instructions.
You can find the Star Map set up dashboard under Extras > Star maps generator
To use this search function, first you need to create a Mapbox account (and Google Places API - optional), and link it to teeinblue. Visit this article for detailed instructions.
This location and time are only used for previewing in this generator. It's not the default location showing on Artwork.
In this section, you have various choices to customize the Star Map. Continue reading below to find more details about them.
You can quickly select a pre-set Style here. By doing so, it can save you a lot of time with the configuration.
Continue reading below to find out more about each configuration
In this panel, you can control:
Toggle: Show/Hide the Star Map
Size: The size of the Star Map
Fill Color: The color of the Star Map
Opacity: The transparency of the Star Map
In this panel, you can control:
Toggle Show: Show/Hide the Constellations
Color: The color of the Constellations
Stroke width: The width of the Constellations
Stroke opacity: The transparency of the Constellation
Name Toggle: Show/hide Constellations' names
Name Type: The Constellations' name types
Name Color: The Constellations' name color
You cannot change the font-family of the Constellations' names
This is a pre-determined setting. The Customers cannot customize it
In this panel, you can control:
Toggle Show: Show/hide the Graticule
Color: The color of the Graticule
Width: The size of the Graticule's line
Opacity: The transparency of the Graticule's line
This is a pre-determined setting. The Customers cannot customize it
In this panel, you can control:
Toggle Show: Show/hide the Milky Way
Fill Color: The color of the Milky Way
Fill opacity: The transparency of the Milky Way
This is a pre-determined setting. The Customers cannot customize it
In this panel, you can control:
Fill Color: The color of the Earth
Opacity: The transparency of the Earth's color
Stroke Color: The color of the Earth's outline
Width: The thickness of the Earth's outline
This is a pre-determined setting. The Customers cannot customize it
Once you are done with the configuration, you can see a snippet of the Star Map here:
It is suggestible to make change to your Star Map from the configuration panel above, not directly here.
Please note that you can only save one configuration at a time. Be sure to copy - paste the configuration into your Artwork first, before creating a new one.
In your Artwork Editor, create a new layer like you normally do, and select the following setting:
You can actually use a special shape of your choice here, but recommend using a layer with ratio 1:1 (square).
However, please note that the Star Map is always a Circle Shape put inside a Square Box. See the below image:
Keep this in mind while you design the special shape for the Star Map. All parts outside the dotted circle will be cut off.
Please keep in mind that the original layer for the Star Map should always be in a square shape as well.
In here, you will find a setting panel for the Star Map feature as well. The first thing you should do should be copying your recently created configuration here:
If you want to update the Star Map configuration, please go back to your Extras > Star maps generator to create a new configuration
In the setting panel inside Artwork Editor, you can:
Set a custom default location (This will override the default location you have set inside Star maps generator page)
Set a custom label for each setting
Set a custom placeholder text for each setting
Set a custom show/hide switch for each setting
The location that maps will show when customers haven't selected a location yet.
You can change it by entering a latitude & longitude of a location.
To get the latitude & longitude of a location: Search a location on Google maps > Right click on the marker > copy the "latitude, longitude" number OR copy it on the url.
Once you are done with the setting inside Artwork Editor, the Campaign should look like this:
If you are happy with the Campaign, you can go ahead and launch it now!
You can now add a custom text field to automatically populate new information such as location name, date, time, longitude, latitude, and more.
In this example, if the Map Location is set to Berlin, Germany, both the text field and the Live Preview will automatically set to Berlin, Germany as well.
To do so, please follow these steps:
Create a text layer like you usually do
Select Populate values from other options
Continue to select the Layer you want to get value from. In this case, it would be the Street Map layer
Select the type of value you want to get. You can click on the Lookup values button for more details. At the moment, we support these values. We will be continuing to update more in the future!
Since you want to get the place name value, then you can copy and paste the {{place_name}} value there.
| Tips: You can also enter a custom text there along with the custom value
Check your results on the Storefront:
Please keep in mind that you can also combine different custom values if you want as well!
NOTES:
Customers can still edit the text field anytime, even after it's been filled.
If the Customers change the map location again, the text field will update with the new values, which could replace any custom info they added before.
If you need any help, please contact us at support@teeinblue.com
The following article will guide you through the set up process of the Star Map feature.
Connect Mapbox & Google Map account
Before we begin, it is required to connect your Mapbox or Google Map account too teeinblue first. This is needed so that you can use the location search function while using the Star Map feature. Visit this article for detailed instructions.
Setting up the Star Map
You can find the Star Map set up dashboard under Extras > Star maps generator
Preview Section
To use this search function, first you need to create a Mapbox account (and Google Places API - optional), and link it to teeinblue. Visit this article for detailed instructions.
This location and time are only used for previewing in this generator. It's not the default location showing on Artwork.
Styling Section
In this section, you have various choices to customize the Star Map. Continue reading below to find more details about them.
Styling
You can quickly select a pre-set Style here. By doing so, it can save you a lot of time with the configuration.
Continue reading below to find out more about each configuration
Stars
In this panel, you can control:
Toggle: Show/Hide the Star Map
Size: The size of the Star Map
Fill Color: The color of the Star Map
Opacity: The transparency of the Star Map
Constellations
In this panel, you can control:
Toggle Show: Show/Hide the Constellations
Color: The color of the Constellations
Stroke width: The width of the Constellations
Stroke opacity: The transparency of the Constellation
Name Toggle: Show/hide Constellations' names
Name Type: The Constellations' name types
Name Color: The Constellations' name color
You cannot change the font-family of the Constellations' names
This is a pre-determined setting. The Customers cannot customize it
Graticule
In this panel, you can control:
Toggle Show: Show/hide the Graticule
Color: The color of the Graticule
Width: The size of the Graticule's line
Opacity: The transparency of the Graticule's line
This is a pre-determined setting. The Customers cannot customize it
Milky Way
In this panel, you can control:
Toggle Show: Show/hide the Milky Way
Fill Color: The color of the Milky Way
Fill opacity: The transparency of the Milky Way
This is a pre-determined setting. The Customers cannot customize it
Background
In this panel, you can control:
Fill Color: The color of the Earth
Opacity: The transparency of the Earth's color
Stroke Color: The color of the Earth's outline
Width: The thickness of the Earth's outline
This is a pre-determined setting. The Customers cannot customize it
Once you are done with the configuration, you can see a snippet of the Star Map here:
It is suggestible to make change to your Star Map from the configuration panel above, not directly here.
Please note that you can only save one configuration at a time. Be sure to copy - paste the configuration into your Artwork first, before creating a new one.
Adding the Star Map configuration to your Artwork
In your Artwork Editor, create a new layer like you normally do, and select the following setting:
You can actually use a special shape of your choice here, but recommend using a layer with ratio 1:1 (square).
However, please note that the Star Map is always a Circle Shape put inside a Square Box. See the below image:
Keep this in mind while you design the special shape for the Star Map. All parts outside the dotted circle will be cut off.
Please keep in mind that the original layer for the Star Map should always be in a square shape as well.
In here, you will find a setting panel for the Star Map feature as well. The first thing you should do should be copying your recently created configuration here:
If you want to update the Star Map configuration, please go back to your Extras > Star maps generator to create a new configuration
In the setting panel inside Artwork Editor, you can:
Set a custom default location (This will override the default location you have set inside Star maps generator page)
Set a custom label for each setting
Set a custom placeholder text for each setting
Set a custom show/hide switch for each setting
How to set up a default location
The location that maps will show when customers haven't selected a location yet.
You can change it by entering a latitude & longitude of a location.
To get the latitude & longitude of a location: Search a location on Google maps > Right click on the marker > copy the "latitude, longitude" number OR copy it on the url.
Once you are done with the setting inside Artwork Editor, the Campaign should look like this:
If you are happy with the Campaign, you can go ahead and launch it now!
Auto populate custom data to a custom text field based on the Map selection
You can now add a custom text field to automatically populate new information such as location name, date, time, longitude, latitude, and more.
In this example, if the Map Location is set to Berlin, Germany, both the text field and the Live Preview will automatically set to Berlin, Germany as well.
To do so, please follow these steps:
Create a text layer like you usually do
Select Populate values from other options
Continue to select the Layer you want to get value from. In this case, it would be the Street Map layer
Select the type of value you want to get. You can click on the Lookup values button for more details. At the moment, we support these values. We will be continuing to update more in the future!
Since you want to get the place name value, then you can copy and paste the {{place_name}} value there.
| Tips: You can also enter a custom text there along with the custom value
Check your results on the Storefront:
Please keep in mind that you can also combine different custom values if you want as well!
NOTES:
Customers can still edit the text field anytime, even after it's been filled.
If the Customers change the map location again, the text field will update with the new values, which could replace any custom info they added before.
If you need any help, please contact us at support@teeinblue.com
Updated on: 21/11/2024
Thank you!