Dev Tutorial [Editor] Aerial Imagery (1 Viewer)

To aid with building highly-accurate real maps, the OMSI 2 Editor can display aerial imagery onto tiles so that the map can be built with everything aligned correctly. For the aerial imagery to work, your map must be using real-world coordinates.

The first step to using Aerial Imagery is to go into /OMSI 2/maps/ and create a directory called aerials. The editor will not create this directory automatically and instead just fail to download any imagery.

Next we need to tell OMSI where to look online to find the aerial imagery. To do this, you need to edit /OMSI 2/options.cfg. Right at the bottom of the file is the tag:
Code:
[Editor_LinkAerial]
Directly under it a link should exist for the site that distributes the aerial images that will be downloaded, but by default it is not set. There are several links available that work here, the easiest to start with is OpenStreetMap imagery:
Code:
http://b.tile.openstreetmap.org/~z/~x/~y.png
Paste this directly below the tag, save the file and then load the Editor. To display the images in the Editor, go to the Tile tab and check the "Use tile aerials" option:
upload_2016-9-17_14-46-15.png
The resolution of the above link is limited to 256px, so leave the slider alone and click "Dnl. current Tile". This will download a JPEG image into the directory you created earlier and apply it to the tile you're on. Additionally, any tiles that have not yet been downloaded will display the most recently downloaded image. As the images are stored locally on your computer, they will now appear each time the tile aerials are activated without having to redownload them. It's also possible to change the link after downloading some images and then download some other tiles with a different mapping style if you want to mix mapping types.

On the subject of changing the link, you'll probably find that the 256px streetmap imagery leaves rather a lot to be desired in terms of detail, but luckily there are alternatives provided by GCMods:
Code:
http://aerial.gcmods.de/toquad.php?x=~x&y=~y&z=~z&apicode=YourBingAPICode
http://aerial.gcmods.de/toquad.php?x=~x&y=~y&z=~z&type=road&apicode=YourBingAPICode
http://aerial.gcmods.de/toquad.php?x=~x&y=~y&z=~z&service=google&hres=1&apicode=YourGoogleAPICode
http://aerial.gcmods.de/toquad.php?x=~x&y=~y&z=~z&service=google&apicode=YourGoogleAPICode
http://aerial.gcmods.de/toquad.php?x=~x&y=~y&z=~z&service=google&type=roadmap&apicode=YourGoogleAPICode

These links give Aerial and Streetmap imagery from Bing and Google, but they don't work unless you provide an API code.

To get an API code to use the Bing imagery, you'll need to go to the Bing Maps Dev Center and sign in with a Microsoft account. Then, go to the My Keys section and create a new Basic/Not-For-Profit key. This will give you a key which you can paste in place of YourBingAPICode in the links above.

To get an API code to use the Google imagery, you'll need to create a Google Maps Static API key, which requires a Google Cloud Platform account, which requires a Debit/Credit card as requests to the API are pay-as-you-go. You get $300 credit with your free trial, which is enough for over 2,000 tiles at max resolution, so it's only really an issue if you are but a child. This will give you a key which you can paste in place of YourGoogleAPICode in the links above.

With the exception of the first Google link, imagery can then be downloaded up to 2048px square. For higher resolutions, the game will appear to freeze for quite some time while the image is downloaded. Google imagery is usually much higher quality and more recent that Bing imagery, however it has a watermark on each 256px square. The first Google link is slightly strange as it only works at the 256px setting, but actually downloads a 512px image with only the one watermark rather than the usual 4...
 
Last edited:
Jun 16, 2018
84
5
219
Yes, I too was happily working with mine for months until I started to get map errors and then the error popped up stating the download failed...

I've verified th eintegrity of the files and every time after the suppsoed download failed, I've noticed that files need to be added back to OMSI2 from Steam.

Perhaps this is irrelevant but this potenitally could be the problem: Sign in to your account (sign in to see)
 

Advertisement

Jun 16, 2018
84
5
219
Have you fully closed steam? I was also having the same issue but turns out steam was still open, it worked after that. Also when your pasting the aerial images link into the options.cfg folder make your you save it and leave it open, else it won't work

Yes that worked! I suppose it's just OMSI being OMSI as perusual... Thank you for the advice!
 
  • Like
Reactions: Emmanuel Conteh

Advertisement

Next we need to tell OMSI where to look online to find the aerial imagery. To do this, you need to edit /OMSI 2/options.cfg. Right at the bottom of the file is the tag:
Code:
[Editor_LinkAerial]
Directly under it a link should exist for the site that distributes the aerial images that will be downloaded, but by default it is not set. There are several links available that work here, the easiest to start with is OpenStreetMap imagery:
Code:
http://b.tile.openstreetmap.org/~z/~x/~y.png
What does this step mean? Editing the options.cfg?
 
Oct 13, 2019
9
0
Pronouns
She/Her
To aid with building highly-accurate real maps, the OMSI 2 Editor can display aerial imagery onto tiles so that the map can be built with everything aligned correctly. For the aerial imagery to work, your map must be using real-world coordinates.

The first step to using Aerial Imagery is to go into /OMSI 2/maps/ and create a directory called aerials. The editor will not create this directory automatically and instead just fail to download any imagery.

Next we need to tell OMSI where to look online to find the aerial imagery. To do this, you need to edit /OMSI 2/options.cfg. Right at the bottom of the file is the tag:
Code:
[Editor_LinkAerial]
Directly under it a link should exist for the site that distributes the aerial images that will be downloaded, but by default it is not set. There are several links available that work here, the easiest to start with is OpenStreetMap imagery:
Code:
http://b.tile.openstreetmap.org/~z/~x/~y.png
Paste this directly below the tag, save the file and then load the Editor. To display the images in the Editor, go to the Tile tab and check the "Use tile aerials" option:
The resolution of the above link is limited to 256px, so leave the slider alone and click "Dnl. current Tile". This will download a JPEG image into the directory you created earlier and apply it to the tile you're on. Additionally, any tiles that have not yet been downloaded will display the most recently downloaded image. As the images are stored locally on your computer, they will now appear each time the tile aerials are activated without having to redownload them. It's also possible to change the link after downloading some images and then download some other tiles with a different mapping style if you want to mix mapping types.

On the subject of changing the link, you'll probably find that the 256px streetmap imagery leaves rather a lot to be desired in terms of detail, but luckily there are alternatives provided by GCMods:
Code:
http://aerial.gcmods.de/toquad.php?x=~x&y=~y&z=~z&apicode=YourBingAPICode
http://aerial.gcmods.de/toquad.php?x=~x&y=~y&z=~z&type=road&apicode=YourBingAPICode
http://aerial.gcmods.de/toquad.php?x=~x&y=~y&z=~z&service=google&hres=1&apicode=YourGoogleAPICode
http://aerial.gcmods.de/toquad.php?x=~x&y=~y&z=~z&service=google&apicode=YourGoogleAPICode
http://aerial.gcmods.de/toquad.php?x=~x&y=~y&z=~z&service=google&type=roadmap&apicode=YourGoogleAPICode

These links give Aerial and Streetmap imagery from Bing and Google, but they don't work unless you provide an API code.

To get an API code to use the Bing imagery, you'll need to go to the Bing Maps Dev Center and sign in with a Microsoft account. Then, go to the My Keys section and create a new Basic/Not-For-Profit key. This will give you a key which you can paste in place of YourBingAPICode in the links above.

To get an API code to use the Google imagery, you'll need to create a Google Maps Static API key, which requires a Google Cloud Platform account, which requires a Debit/Credit card as requests to the API are pay-as-you-go. You get $300 credit with your free trial, which is enough for over 2,000 tiles at max resolution, so it's only really an issue if you are but a child. This will give you a key which you can paste in place of YourGoogleAPICode in the links above.

With the exception of the first Google link, imagery can then be downloaded up to 2048px square. For higher resolutions, the game will appear to freeze for quite some time while the image is downloaded. Google imagery is usually much higher quality and more recent that Bing imagery, however it has a watermark on each 256px square. The first Google link is slightly strange as it only works at the 256px setting, but actually downloads a 512px image with only the one watermark rather than the usual 4...
Where abouts would I put the links/code for the aerial download?
 

Advertisement

Albastru

Somebody stole my fantasy
Forum Moderator
Feb 11, 2018
1,270
29
3,393
Brighton & Hove, East Sussex, England
Pronouns
They/Them

Advertisement

This thread is more than 51 days old.

Your message may be considered spam for the following reasons:

Users who are viewing this thread