Articles on: Artworks
This article is also available in:

How to set up Star Maps

You can now use the Star Map feature.


Star Map


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.


Setting up a Preview Location


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


Selecting a Style


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


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


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' namesThis is a pre-determined setting. The Customers cannot customize it


Graticule


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


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


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:


Your Star Map configuration


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).


Heart-shaped Star Map


However, please note that the Star Map is always a Circle Shape put inside a Square Box. See the below image:


How the Map is displayed inside Artwork Editor


Keep this in mind while you design the special shape for the Star Map. All parts outside the dotted circle will be cut off.


How the special shape works


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:


Copying your configuration


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:


Finalizing Settings


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

Was this article helpful?

Share your feedback

Cancel

Thank you!