FAQ

You can use the built-in map editor to change country names permanently. For runtime multi-language support, assign the translated name to country.customLabel and call Redraw(). The asset uses customLabel instead of the database name when set.

Country country = map.GetCountry("Spain");
country.customLabel = "Espana";
map.Redraw();

Make sure Show Provinces is enabled in the Inspector. Province data is stored separately — if you deleted geodata files to reduce build size, the province file may be missing. Also check the Provinces Zoom Level setting, which controls how close the camera must be before provinces appear.

Yes. All Earth styles work on Android and iOS except the atmosphere scattering style, which requires desktop-class GPU. For best mobile performance, use lower-resolution frontier data and limit the number of visible cities.

No. All cartography data (countries, provinces, cities) is included offline. An internet connection is only needed if you enable the online tile map integration feature.

World Map Globe Edition supports Built-in, URP, and HDRP. Choose the pipeline that matches your project. If using URP with Forward rendering, set Depth Priming Mode to Disabled in the Universal Renderer asset.

Yes. The built-in World Map Editor lets you create, merge, split, and reshape countries and provinces. Changes are saved to the geodata files. You can also modify borders at runtime via the C# API.

The Globe Edition renders a 3D sphere that users rotate in 3D space. The 2D Edition renders a flat rectangular map projection. Both share the same cartography data and similar APIs, but the rendering and interaction models are different. Choose based on your project needs.

Yes. All Kronnect assets are fully compatible with Unity 6. The minimum supported version is Unity 2022.3 LTS, and this includes Unity 6 and any newer releases.

Iterate through the countries array (map.countries) and assign customLabel to each country entry programmatically. You can also use decorators for this purpose—refer to the documentation for decorator features. This approach is better for temporary values like supporting multiple languages, whereas the Map Editor makes permanent changes.

map.countries is an array of Country objects that contains data for each country. The structure and properties of each Country object are documented in the Countries API documentation at https://kronnect.com/guides/world-map-globe-edition-countries-api/. You should reference this documentation to understand what properties are available in each Country object and how to properly modify them programmatically rather than attempting manual edits that get overwritten during builds.

Call the Redraw() method to refresh labels after changing texts.

Use the customLabel property instead of the name property. The name property is a human-readable identifier that may be used by other parts of the asset (such as cities), while customLabel is specifically designed for displaying different names. This is particularly useful for localization to other languages.

Use the Distance functions included in the Conversion static class, which implements the great circles algorithm. This provides accurate distance calculations between two sphere points or lat/lon coordinate pairs. Refer to the documentation for the specific function signatures and usage.

Use the AddMarker API to draw a circle. There is an example in demo scene 1 with a button labeled 'Add Marker (Circle)' that demonstrates this functionality.

Use the Conversion static class directly for coordinate conversion and distance calculations in code. While the calc component can be used from code, it was primarily designed for inspector use. The Conversion class provides all necessary methods and is the better choice for code-based conversions.

Neighbours must share at least a polygon edge. Simply being visually adjacent is not sufficient - the provinces need to have a shared edge in their polygon data for pathfinding to recognize them as connected.

Use map.InverseTransformPoint(worldPosition) to convert world position to local position. Then use map.GetCountryIndex(localPosition) to get the country index. Alternatively, you can use the Conversion static class or the Calculator component (map.calc) for coordinate conversions.

The asset has rendering issues with Multi-View VR mode. In non-VR mode it renders fine with Forward+ rendering, but on Deferred rendering the textures do not display properly. Multi-Pass VR rendering appears to work without significant issues.

Set the geodata format to binary in the settings, then use the map editor to make a change (any modification) to force the files to be flagged for update. Save from the editor, and the geodata will be converted to binary format.

The entire geodata dataset is saved when you make any changes, not just the individual city being edited.

The downloader tool allows you to select a portion of the world by defining a rectangle using latitude/longitude corners. It does not support selecting individual tiles, but you can use this rectangular selection to limit the download area to your desired region at the specified zoom level.

Please visit the Support Center and use our AI Support Assistant to get answers. If the issue persists, submit a reproduction project so we can investigate further and help you.