### Basics

GEOlayers 2 connects your After Effects directly to geo-webservices. It hooks you up with up-to-date imagery and geospatial vectordata from all around the globe. It comes with a bunch of default server profiles and map styles and is easily expandable.

##### Mapcomps

To start a project you need to create a so called Mapcomp.

> Mapcomps are Compositions filled with online imagery tiles.

> They are the basic building block of each GEOlayers 2 project.

Clicking the `add Mapcomp` button in the upper left corner of the main palette will open the Create Mapcomp Dialog. Here you can specify all the options for your Mapcomp.

Note that a white corner bottom right on buttons indicates that you can right-click it. Right-clicking this button will open the Quick Setup options.

Create Mapcomp Options

Name
  Type in a name for your Mapcomp here. This name needs to be uniqe in the whole After Effects project.

Basic Composition settings
  Here you can find the pixelsize, pixel aspect, framerate and duration. You can edit those settings afterwards if needed.

Server Profile
  Set your maps style here. Server Profiles describe the connection to an online or local tileserver. You can set them up in the preferences' Server Profiles section.

link View to
  If you have multiple Mapcomps in your project you can link their views.

use 'Motion Tile' Effect
  This means each Tile in your Mapcomp will be extended by 1 pixel. This will fill visual gaps between the tiles that result from antialiasing.

Blend Zoomlevels
  During a zoom animation GEOlayers 2 will blend imagery to get smooth transitions.

Blend Duration
  The maximum number of frames the transition will take

Finalization Quality
  The Quality of your Mapcomp. Less Quality means less tiles to be downloaded. Note that 70% is absolutely enough for most cases and speeds up your workflow.

Hit `Create` and your first Mapcomp will be built. Mapcomps get placed in the composition that is selected when you create them. If you rename the containing composition in your project some of GEOlayers' referencing will break. In this case click the name of the Mapcomp in the Mapcompbar to repair it.

Aside your Mapcomp you'll find a text layer and a provider logo(depending on the Server Profile). Keep those layers visible in your final animation to attribute the map. To get rid of this you'll need to get in touch with the map provider.

You can duplicate Mapcomps. There is two ways to do this.

Duplicate containing Comp and contents
  Choose this setting to duplicate the containing Comp with all Mapcomps and their Labels, Markers, Overlays and related layers.

Duplicate Mapcomp
  Duplicate only the Mapcomp itself inside the containing Comp.

Allways delete Mapcomps using the `Remove Mapcomp` button in the Mapcomp bar. This will additionally remove not used tiles from your After Effects project.

Click `Edit Mapcomp` in the Mapcomp bar to change your Mapcomp settings. Its the same options like in the Create Mapcomp Dialog.

If the Mapcomp has a foreign Server Profile you can import it to your preferences.

Additionally you can find the `repair Expressions` button. Click it to update every GEOlayers 2 Expression related to the Mapcomp like Labels, Markers and Overlays. Do this in case you changed the name of the Mapcomp or containing comp.

##### Animate Mapcomps

Use the Scroll- and Zoomcontrols to browse your map. By clicking the `Add Keyframe` button GEOlayers will keyframe the Latitude, Longitude and Zoom property on your Mapcomp layer. To animate the map just drag your Current Time Indicator some seconds later and change your Mapcomps view. Notice that Keyframes get created as you change it.

##### Finalize Mapcomps

Once you are done with tweaking Keyframes you need to Finalize your Mapcomp. Do so by clicking the `Finalize` button top right. GEOlayers 2 will now analyse your animation, calculate the requirement of tiles, download and place them in your Mapcomp, blend zoomlevels and update the provider attribution text layer.

You can hold `SHIFT` clicking `Finalize` to finalize the whole animation in preview quality.

You can hold `CTRL/CMD` clicking `Finalize` to finalize only the current frame.

Right-click the `Finalize` button to open the finalization options.

Finalization Options

Use global Finalization Quality
  If checked all Mapcomps will be finalized with the quality you set up below instead of their own quality setting.

Finalization Quality
  The global finalization Quality.

Analization Accuracy
  Set this to 100% to analyse each frame of your animation. This is needed for quick animations. In normal cases 50% works well and is faster.

Mode
  Select a mode to finalize either the selected Mapcomp, the selected Mapcomp and the ones that are linked to it or all Mapcomps.
  - finalize
  - finalize linked
  - finalize all

### Toolbar

Find the Toolbar right below your Mapcomp bar.

##### Markers

Markers are layers that are snapped to a certain location. They are not scaled according to the zoom of your Mapcomp.

Select a layer from the composition that is containing your selected Mapcomp as well. Then click the `Marker` button to snap it to your map. If you don't select any layer a null will get created instead. On the Marker you'll find a "Scale with map" property and a "latitude longitude height" property to animate.

##### Overlays

Overlays work the same as Markers but are scaled according to the zoom.

##### NW-SE Overlays

NW-SE Overlays are Overlays that are positioned by two geo-points the north-west and the south-east corner.

##### Geospatial Files

Click this to select a geospatial file and draw it directly to your selected Mapcomp. GEOlayers 2 supports .shp, .geojson, .kml, .gpx, and .csv/tsv(with Lat and Lon fields) format. Those files can also be browsed in the Feature Browser.

#####
Label selector

Select a Label Template here. This template is used when you label a Feature. Clicking the icon on the bottom of the list you can add a Label Template composition to your project. Each Composition that is inside `GEOlayers 2 itmes/Label Templates` in your After Effects project is noticed by GEOlayers 2 as a Label Template and will appear in this list.

Add manual Label
  Creates a Label in the center of your current view. If any additional data like a name is required for the Label a dialog to type it in is shown.

Swap Label Template
  If you have Label layers selected in a composition, you can swap their Label Template with the currently selected.

#####
Feature Style selector

Select a Feature Style here. This Style is used when you draw a feature. An "A" in the thumbnail indicates whether the Style is automatically selected according to the Features properties. This is done using Style Rules

Right click the Feature Style selector to edit your Styles and Rules.

Swap Feature Style
  If you have Shape layers selected in a composition, you can swap their Style with the currently selected.

### Searchbar

Use the searchbar to find locations and POIs using online geocoding services. You can either type in a searchterm or click the `Current View` button on the left side. Results will be displayed below. Click their name to jump to the Feature on your Mapcomp. You can hold `ALT` to fit the Feature exactly to your Mapcomp borders or `CTRL/CMD` to don't change the zoom at all.

As you hover over the results additional options appear:

Current View
  Fit your Mapcomps view to the Feature. You can hold `ALT` to fit the Feature exactly to your Mapcomp borders or `CTRL/CMD` to don't change the zoom at all.

Label Feature
  Add a Label for the Feature to your Mapcomp.

Draw Feature
  Downloads geometry and draws the Feature directly to your Mapcomp.

Add to Favorites
  Downloads geometry and adds the Feature to your Favorites in the Feature Browser.

Add to Browser
  Downloads geometry and adds the Feature to your Feature Browser.

License Info - Feature download from Searchbar

If you show Data aquired with this service it needs to be attributed as follows: `©OpenStreetMap contributors`.

### Feature Browser

Browse and manage your geographic Features here. Drag them around or `ALT + DRAG` to copy Features. You can jump to them on your Mapcomp, label and draw them or have a look at their properties. The ones you add to your Favorites will be saved and loaded as you launch GEOlayers 2.

If you have auto apply Style option enabled you'll see each Features' Style on the right side of the browser. This is the Style that is applied if the Feature matches any Style Rule Or you have applied a custom Style to the Feature. If you don't see a Style thumbnail there the Feature doesn't fulfill the conditions of any Rule and no Custom Style is applied for the Feature.

> Features are geospatial geometries. One of Point, Line, Polygon or a combination. They can have additional data stored as Properties.

##### Add Features

You have several options to add Features to the browser:

Add geospatial File
  Select a geospatial File and add it to your browser. GEOlayers 2 supports .shp, .geojson, .kml, .gpx and .csv/tsv(with Lat and Lon fields) format.

Add Current View
  Adds the Current View of your selected Mapcomp to the browser. This is a simple Point Geometry.

Download Features for Current View

  This function gives you all the features you'll need at your fingertips. Click it and choose from a global data set from Natural Earth or local data from OpenStreetMap.

License Info - Feature download

This Service is powered by Natural Earth and OpenStreetMap.

If you show Data aquired with this service it needs to be attributed as follows: `©OpenStreetMap contributors`.

Add a Route
  You can use online routing services and import routes directly to GEOlayers 2. Select up to 5 Features before you click it to calculate the Route between them.

License Info - Routes

This Service is powered by Openrouteservice.

##### Filter Features

To don't get lost in all the Features you can filter them. Just type in a searchterm.

Anything

  A simple word will check all Feature properties for a match.

Certain Properties

  You can also filter by certian properties. Do this by typing in the property name, an operator and a value. For Example `kind=country` or `population<100000`.

Rules

  It is also possible to filter by your own Rules. Type in `rule:` and the name of the Rule.

Styles

  Last but not least you can filter by your own Styles. Type in `style:` and the name of the style.

  There is also the three keywords: `style:any`, `style:none` and `style:custom`.

  Note that Style filters are very ressource intense! Be carefull if you have a lot of Features in the Browser.

All the searchterms can be connected by `&&` (and) or `||` (or).

Additional to that you can filter geometry types. Each Features geometry is one of Point, Line, Polygon or a combination.

Geometry Types

Point geometry
  A geometry consisting of one or more points.

Line geometry
  A geometry consisting of one or more lines.

Polygon geometry
  A geometry consisting of one or more polygons.

Activate the Current View filter to only show Features that are in the Current View of your selected Mapcomp.

##### Feature actions

If you have Features selected a set of buttons appear under your Feature Browser.

jump to Feature
  Clicking will fit your selected Mapcomps View to the selected Feature(s). You can hold `ALT` to fit the Feature exactly to your Mapcomp borders or `CTRL/CMD` to don't change the zoom at all.

snap Marker to Feature
  Select a layer in the Composition that contains your selected Mapcomp. By clicking this button the layer will be snapped to the Mapcomp at the selected Feature's position. Right-click to check the `animate along Feature` setting. Then the layer will be animated along the selected Line Feature or Polygon Feature's outline. You can also orient the layer along its path. Don't use AEs built in function for this since it will mess up because of relative movements on a keyframed mapcomp.

snap Label to Feature
  Clicking will add a Label to your selected Mapcomp. Right-click to check the `animate along Feature` setting. Then the Label will be animated along the selected Line Feature or Polygon Feature's outline. Use this function to quickly animate symbols along Routes or GPX data. You can also orient the label along its path. Don't use AEs built in function for this since it will mess up because of relative movements on a keyframed mapcomp.

draw Feature
  Clicking will draw the selected Feature(s) to your selected Mapcomp. A Right-Click lets you direct draw it in the selected Style alltough you might have Style Rules applied.

Create Feature Mesh
  Creates a Feature Collection in the browser consisting of Points from all selected Features and Lines connecting them. A Right-Click gives you the option to create either straight Lines or the shortest geographical route between the Points. You can use it for flight routes.

Feature Properties
  Click to have a look at the Feature's properties. You can also change its name and apply custom Styles.

Feature Properties

Here you can change the Features' name and apply a custom Style to it. This style will be used to draw it when auto apply Style setting is on.

You can also directly create Rules from certain properties.

Select one or more properties and a rule preset will appear on the bottom of the dialog. You can then adapt the condition and either add it to an existing Rule or create a new one from it.

If you have only one Property selected you can also use it for naming all the Features of the containing Feature Collection.

Add to Favorites
  Adds the selected Feature(s) to your Favorites.

Create Feature Collection
  Wraps the selected Features in a Feature Collection.

Export selected Features
  Exports the selected Features to a `.geojson` file.

Remove from Browser
  A way too complex process to describe in words.

### Draw Features

You can draw geospatial data to After Effects shape layers. The shape layers are snapped as Overlays to your selected Mapcomp. GEOlayers 2 lets you create custom Feature Styles. Those Styles define things like Fill and Stroke colors, Stroke width ect. You can select Styles yourself for drawing or apply Rules to automatically select a Style. Rules are conditions that Features can fulfill. If they do so a certain Style is used to draw them. For example if your Feature is water then draw it blue.

##### Feature Style Editor

This is the place for all settings related to drawing Features. To open the `Feature Style Editor` right-click the Feature Style selector in the Toolbar.

At the top of the dialog you can reset, import and export Feature Style Sets.

If you have `Sync Feature Style Set with After Effects Project` in the prefs general section checked the Style Set will be saved in your After Effects Project. Like this it can easily be shared within the .aep File. If this setting is not checked you can manually load and save it in your Project.

Reset Feature Style Set
  Click this button to reset the Feature Style Set to the defaults.

Import Feature Style Set from File
  Click this button to import a Feature Style Set. These Sets contain Styles and related Rules. Note that importing a Set will overwrite all the existing Styles and Rules.

Export Feature Style Set to File
  Click this button to export a Feature Style Set to a file. These Sets contain Styles and related Rules.

Load Feature Style Set from Project
  Click this button to load the Feature Style Set from your After Effects Project. These Sets contain Styles and related Rules. Note that importing a Set will overwrite all the existing Styles and Rules. This Button is not visible if you have `Sync Feature Style Set with After Effects Project` in the prefs general section checked.

Save Feature Style Set to Project
  Click this button to save the Feature Style Set in your After Effects Project. These Sets contain Styles and related Rules. This Button is not visible if you have `Sync Feature Style Set with After Effects Project` in the prefs general section checked.

Some general options for drawing are placed on the bottom of the dialog.

reduce Detail according to Current View
  This means that GEOlayers 2 will simplify the Features' geometry before it will draw it. Its recommended to keep this setting checked since otherwise performance and rendertimes can be increased enormously. Note that the geometry detail is automatically adapted according your selected Mapcomps Current View.

draw on individual layers
  If you draw more than one Feature at a time you can define whether they are drawn on a single or individual shape layers.

auto animate Stroke Width
  If checked GEOlayers 2 will add an expression to the Stroke Width to animate it according to the zoom. If you don't explicitly need it switch it off since it increases rendertimes.

##### Styles

> A Style is a definition of how Features will be drawn to shape layers. It defines Colors, Opacities, Strokes, Extrusion etc.

Create and edit your Feature Styles here.

Add Style
  Click to add a Style to your Set.

Duplicate Style
  Click to duplicate the selected Style.

Remove Style
  Click to remove the selected Style from your Set.

Change the order of your Styles by dragging them around in the dropdown.

The selected Style can be edited below. You can select whether a Fill and a Stroke should be drawn. Unlike Polygons, Line and Point geometries will be drawn with a Stroke also if it is not checked. For each of the both you can define a color and a opacity. The Stroke has some additional options. The Width, which is relative to your selected Mapcomps current view, and a dash slider. Use it to draw your Stroke dashed or dotted. Note that this increases the time for the drawing process.

A Style can also contain an Extrusion. The containing Composition renderer will be set to CINEMA 4D therefore. Note that despite you haven't checked `draw Features on individual layers` Features with a different Extrusion will be drawn on separate layers due to After Effects limitations.

##### Data-driven Styling

Each setting can be data driven. Click the button to automatically adapt the setting by a certain Property of a Feature.

Therefore type in the Property's name and a value range. Like this you can for example colorize the Stroke according to the drawn Features' population Property. If you define numbers in the value range colors in between will be interpolated whereas simple words will just change the setting on an exact match. Numbers can be treatened as a string or word if you use quotation marks.

By checking `rnd` the setting will be randomized in the gived value range.

The little icon in the Style thumbnail indicates that the Style has at least one data driven setting. Thumbnails in the Feature Browser also preview data driven settings.

##### Rules

> A Rule is a set of conditions a Feature can fulfill. If it does so a Rule can apply a certain Style to the Feature.

Create and edit your Rules here.

Add Rule
  Click to add a Rule to your Set.

Duplicate Rule
  Click to duplicate the selected Rule.

Remove Rule
  Click to remove the selected Rule from your Set.

Change the order of your Rules by dragging them around in the dropdown.

Note that Rules will be evaluated from top to bottom in this list. That means that if a Feature fulfills the conditions of two Rules the Style of the one lower in the list will be applied.

In the first section you can define which geometries to be taken in account.

Geometry Types

Point geometry
  A geometry consisting of one or more points.

Line geometry
  A geometry consisting of one or more lines.

Polygon geometry
  A geometry consisting of one or more polygons.

The second section lets you create multiple property conditions.

Add Property Condition
  Click this button to add a Property Condition.

Property conditions check if a certain Property of a Feature matches a Value you define. Something like `kind is country`, `population > 1000000` or `osmSourceLayer is water` You can have a look at a Features' properties by clicking the Feature Properties button in the Feature Browser.

In the last line you define a Style that should be applied if all conditions of the Rule are fulfilled. If you don't select a style you can simply use your Rule to filter Features in the Feature Browser.

### Label Features

GEOlayers 2 allows you to use custom Compositions to label Features. You can label Features from the Feature Browser or directly from the Searchbar. In the Toolbar you select the Label Template.

##### Label Templates

GEOlayers 2 Label Templates are stored in your After Effects project under `GEOlayers 2 itmes/Label Templates`. You can add and remove Compositons to this Folder and use them as your custom Labels. On an empty project a default set of Labels will be loaded.

##### Default Labels

GEOlayers 2 comes with a set of default Label Templates. They are set up for 2 color schemes and can be customized. To do that open the following Composition: `GEOlayers 2 itmes/Items/Label Settings/LabelColors`. There you can adjust the fill colors of the containing shape layers or simply hide them if you don't want straps for example.

##### Create custom Labels

Each Composition that is inside `GEOlayers 2 itmes/Label Templates` in your After Effects project is noticed by GEOlayers 2 as a Label Template. Note that the Labels anchor point is at the center of the Template Composition by default. If you want it to be somewhere else add a layer called `Label Anchor Point` to your template composition. This layer should not be parented to another. The anchor point of each Label created with this template will then be adjusted to this layers' position in the template comp. Additional to this an expression will link its position to the Labels anchor point. This allows dynamic labels.

Text layers that are not locked are used as template fields. The text layers' name or content defines the text that is inserted to it as you create a Label.

- Any random name will tell GEOlayers 2 to insert just the Feature name.
- A Feature Property in curly brackets in the name or text layers' content will lead to replacing the source text with a certain property's value. Multiple properties are supported. So a text layers name or content could be `{population}` or `Latitude: {lat}, Longitude: {lon}` for Example.

Footage layers that are not locked and are named like a Property in curly brackets are used as footage template fields. The layers' source will be replaced when the Feature provides a suitable Property for this. Properties can hold the following data:

- An absolute local path to a file with or without file extension `D:\my_folder\my_file(.jpg)`
- A local path or filename with or without file extension that is relative to the template footage `my_file(.jpg)`
- A http or https uri `http://www.myserv.er/my_image.jpg`

Inspect a Features' properties by clicking the Feature Properties button in the Feature Browser.

### Quick Setup

Right-click the `Create Mapcomp` button to open the Quick Setup popover. From here you can quickly create Mapcomp setups.

Create Controller Mapcomp
  Creates a simple controller Mapcomp. These Mapcomps do not download tiles. You can link others to them, add labels or draw Features on them.

Create Land Mask Mapcomp
  Creates a Luma Land Mask Mapcomp that is linked to your selected Mapcomp.

Create 3D Landscape

  A 3D Setup consisting of a Texture, Heightmap and Controller Mapcomp will be created. This button is visible if you have either `Trapcode Mir 2`, `Mettle FreeForm Pro` or `Rowbyte Plexus 3` installed. If you have multiple plugins installed you can choose it from the dropdown.

### Projects

Find the projects panel in the Flyout Menue of the Extension.

##### Create a new Project

Click this button to create a new GEOlayers 2 Project with the default Label Templates, Feature Styles and Rules. If you have set up custom Label Templates or a custom Feature Style Set those will be loaded.

##### Recent Projects

This helps you find and open your recent mapping projects as quick as possible.

##### Sample Projects

You can download Sample Projects to get you started. The Projects can contain Feature Styles and Label Templates. Also features can be delivered with the Project. In this case they will be added to your Browser when the Project is loaded.

If there is a
top right you can also watch a related video to learn more.

Label Template Projects can be directly imported to your GEOlayers 2 Project if one is open in AE.

##### Tutorial Projects

### Preferences

Find GEOlayers 2 preferences in the flyout menue or by right-clicking somewhere on the panel.

##### General

max. Tiles for preview
  Choose the maximum number of Tiles in not finalized Mapcomps.

Tiles Directory
  Choose a directory to store downloaded Tiles. Note that you should allways collect Files on finished projects since GEOlayers 2 will dynamically overwrite files in the Tiles Directory

Update Views of linked Mapcomps
  If checked preview tiles will be downloaded for the selected Mapcomps and mapcomps that are linked to it.

Language
  The language that is used for certain server requests that support different languages and feature naming in the browser.

##### Features

Default geospatial Files
  Select geospatial Files to be imported to the Feature Browser when you launch GEOlayers 2.

##### Labels

Switch on collapse transformation on Labels
  If checked collapse transformation will be switched on for each Label you create.

Make Labels 3D layers
  If checked each Label you create will be a 3D layer by dafault.

custom Label Templates
  If checked you can coose an After Effects project containing Label Template compositions. All comps of the project will appear as Label Templates unless you include `ignore_` to their names or put them into any folder. Do this with precomps you don't want to show up as Labels. They will appear in the `items` folder in your project.

Frames to jump forward after Label creation
  GEOlayers 2 will jump forward in time after the creation of a Label. Otherwise you won't see it since most Labes are animated in.

##### Styles and Rules

Sync Feature Style Set with After Effects Project
  If checked the Feature Style Set will be saved in your After Effects Project. When you open a new project that has a Feature Style Set it will be loaded automatically.

custom Feature Style Set
  If checked you can select a custom Feature Style Set that is loaded when you launch GEOlayers 2. This will be used when you create a new Project or reset the Feature Styles.

##### Internet

Proxyserver
  You can set up a proxyserver here. Note that this is for all downloads and data requests. The UI uses the system proxy settings.

##### Server Profiles

> A Server Profile represents the connection to an imagebased Tileserver. So basically it's something like a Mapcomp style.

Create and edit your Server Profiles here.

Add Server Profile
  Click to add a Server Profile to your Set.

Duplicate Server Profile
  Click to duplicate the selected Server Profile.

Remove Server Profile
  Click to remove the selected Server Profile from your Set.

You can drag your Server Profiles around in the dropdown to change their order.

Import Server Profile(s)
  Click this button to import Server Profiles.

Export Server Profile(s)
  Click this button to export one Server Profile or a Server Profile Set to a File.

Each Server Profile has a certain API.

bingmapsApi

GEOlayers 2 supports bing aerial, road and hybrid imagery. A tile size of 512 px is recommended for performance reasons. You can define your own API Key if you want. Thats all the options you have here.

univarsalApi

The universalApi allows you to connect to any WGS84 tileserver. All you need to do is to paste a URI Mask. Note that it can also refer to local directories. This mask can contain the following variables.

{x}
  The tile column.

{y}
  The tile row.

{yi}
  The inverted tile row. Use for servers with tms tile convention.

{z}
  The zoomlevel.

{quadkey}
  Quadkeys are used by bing for example to identify a tile.

{fileextension}
  The file extension chosen behind the URI Mask field.

{ISO639}
  ISO 639 code of the language selected in the preferences.

{IETFBCP47}
  IETF BCP 47 tag of the language selected in the preferences.

{tilesize}
  The tile size chosen behind the URI Mask field. Note that GEOlayers 2 will automatically detect the pixel size of the tiles you're downloading. If you set a higher tile size than the server delivers, GEOlayers 2 will merge those tiles.

You can define a maximum zoomlevel. Check this using the preview map below.

If the Tiles have transparency you should check `crossfade zoomlevels`. This means that lower zoomlevels are faded out as higher ones are blended in.

GEOlayers 2 will check if a Server needs Basic Authorization. If so you will see a Username and Password field.

You can also set up default attribution for the Server Profile. A Copyright String and a logo are possible. Just paste a url or a local path to the logo. Note that the image format needs to be supported by After Effects.

mapstackApi

The mapstackApi is a great service from stamen design. This Api allows you to quick and easily create custom mapstyles.

Therefore you find a layerstack on the left side. You can add, duplicate and remove layers as well as drag them around in the stack. The upper ones are rendered on top of the lower ones. Selecting a layer you have its options on the right side.

Layer Name
  Name of the Layer in the stack

Map Layer
  Choose a basic map layer or a solid color here. You can also invert its colors.

Opacity
  The Map layers opacity.

Brightness
  The Map layers brightness.

Saturation
  The Map layers saturation.

color tint
  Check this and select a color and tint amount to tint the Map Layer.

Mask
  You can also mask the Map Layer.

Blend Mode
  Select a blend mode to the Map layers below in the stack.

If your style has transparency you should check `crossfade zoomlevels`. This means that lower zoomlevels are faded out as higher ones are blended in.

mapboxApi

The mapboxApi allows you use GEOlayers 2 with your mapbox account.

Access Token
  Paste your accounts Access Token here.

Username
  Paste the Username you used in your mapbox account here.

Map ID
  Coose one of mapbox' standard map styles or paste your own Map ID. Map IDs for Mapbox Studio projects, not the classic ones, are actually the last part of the url when you preview your map on mapbox.com. If you create your own access token make sure you enable the scope `styles:list` to allow GEOlayers to read your custom styles.

Tile Size
  You can also choose the size of the tiles. 512px tiles are recommended. If you're working with high resolutions you can choose 1024px tiles. This will speed up finalization but will be a little slower in preview mode.

If the Tiles have transparency you should check `crossfade zoomlevels`. This means that lower zoomlevels are faded out as higher ones are blended in.

wmsApi

The wmsApi allows you use GEOlayers 2 with wms(web map service) servers that support EPSG:3857(webmercator) projection.

WMS Url
  Paste a url to a wms here. This url should lead to the capabilities of the wms.

File Format
  You can decide which file format you want GEOlayers 2 to request from the wms. Note that jpg doesn't support transparency.

Tile Size
  You can also choose the size of the tiles. 512px tiles are recommended. If you're working with high resolutions you can choose 1024px tiles. This will speed up finalization but will be a little slower in preview mode.

Once you've pasted a valid wms url you will be able to see a list of layers the wms provides. You can check, uncheck and sort them by drag and drop.

WMS layers can have multiple display styles. If a layer has more than one style GEOlayers 2 will show a dropdown of all available styles to choose from.

If the Tiles have transparency you should check `crossfade zoomlevels`. This means that lower zoomlevels are faded out as higher ones are blended in.

### Disclaimer

The terms of use of the map service providers apply. Content must be attributed unless otherwise agreed with the map service provider.

GEOlayers cannot ensure that every tileserver, geocoding-service etc. works properly all the time as certain functions will not work if servers are down which are out of our control.

The creators of GEOlayers reserve the right not to be responsible for the topicality, correctness, completeness or quality of the information provided or acquired with this software from the map service providers. Liability claims regarding damage caused by the use of any information provided, including any kind of information which is incomplete or incorrect, will therefore, be rejected. All offers are not-binding and without obligation.

The creators of GEOlayers do not claim any ownership or license for the images and data you acquire with this software from any map service provider.