UWP中使用Image控件加载OpenStreetMap瓦片图层无法显示求助

问题原因 #

OpenStreetMap（OSM）瓦片服务器对请求的User-Agent有严格限制，目的是防止服务滥用。UWP的BitmapImage默认发起请求时使用的User-Agent不符合OSM规范，会被服务器拒绝，导致图片加载失败、显示空白。

解决方案 #

方案1：通过HttpClient自定义请求头加载图片 #

使用HttpClient发起请求并添加合法的User-Agent，下载图片流后再赋值给BitmapImage：

修改MainPage.xaml.cs代码如下：

using System;
using System.Diagnostics;
using System.IO;
using System.Net.Http;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.Storage.Streams;

namespace BitmapImageDemo
{
    public sealed partial class MainPage : Page
    {
        public MainPage()
        {
            this.InitializeComponent();
            _ = LoadOsmTileAsync();
        }

        private async System.Threading.Tasks.Task LoadOsmTileAsync()
        {
            using var httpClient = new HttpClient();
            // 设置符合OSM要求的User-Agent，替换为你的应用信息
            httpClient.DefaultRequestHeaders.UserAgent.ParseAdd("YourAppName/1.0 (your-contact-email@example.com)");
            
            try
            {
                var stream = await httpClient.GetStreamAsync("https://tile.openstreetmap.org/1/1/0.png");
                var randomAccessStream = new InMemoryRandomAccessStream();
                await stream.CopyToAsync(randomAccessStream.AsStreamForWrite());
                randomAccessStream.Seek(0);

                var bitmapImage = new BitmapImage();
                await bitmapImage.SetSourceAsync(randomAccessStream);
                image.Width = bitmapImage.DecodePixelWidth = 256;
                image.Height = bitmapImage.DecodePixelHeight = 256;
                image.Source = bitmapImage;
            }
            catch (Exception ex)
            {
                Debug.WriteLine($"加载失败: {ex.Message}");
            }
        }
    }
}

方案2：检查应用网络权限 #

确保你的UWP应用已声明Internet (Client)权限：

1. 打开Package.appxmanifest文件
2. 切换到"功能"标签页
3. 勾选"Internet (Client)"选项

关键注意事项 #

• 必须使用符合OSM要求的User-Agent，格式建议为应用名称/版本号 (联系邮箱)，否则可能被服务器永久封禁IP。
• 避免频繁请求OSM瓦片，遵守OSM的使用政策。

内容的提问来源于stack exchange，提问作者Vishal O