Dotnet-11 | The .NET Blog

ピンクラスタリングがついに .NET MAUI Maps に登場 — プロパティ1つ、手間ゼロ

Emiliano Montesdeoca — Thu, 16 Apr 2026 00:00:00 +0000

この記事は自動翻訳されています。原文はこちらをご覧ください。

マップに100個のピンを読み込んだら、全体が読めない塊になった — そんな経験ありませんか？そう、これまでの .NET MAUI Maps はまさにそんな感じでした。もう終わりです。

David Ortinau が発表しました。.NET MAUI 11 Preview 3 では、Android と iOS/Mac Catalyst でピンクラスタリングがすぐに使える状態で搭載されています。そして最高なのは — 有効にするのが驚くほど簡単だということです。

すべてを支配する1つのプロパティ

<maps:Map IsClusteringEnabled="True" />

これだけです。近くのピンがカウントバッジ付きのクラスターにグループ化されます。ズームインすると展開。ズームアウトすると折りたたみ。モダンなマップならどれでも期待される動作 — それがたった1つのプロパティで手に入ります。

独立したクラスタリンググループ

ここからが面白いところです。すべてのピンが一緒にクラスタリングされるべきではありません。コーヒーショップと公園は別物で、マップもそれを知っているべきです。

ClusteringIdentifier プロパティを使えば、ピンを独立したグループに分けられます：

map.Pins.Add(new Pin
{
 Label = "Pike Place Coffee",
 Location = new Location(47.6097, -122.3331),
 ClusteringIdentifier = "coffee"
});

map.Pins.Add(new Pin
{
 Label = "Occidental Square",
 Location = new Location(47.6064, -122.3325),
 ClusteringIdentifier = "parks"
});

同じ識別子を持つピンは一緒にクラスタリングされます。異なる識別子は、地理的に近くても独立したクラスターを形成します。識別子なし？デフォルトグループです。シンプルで予測可能。

クラスタータップの処理

ユーザーがクラスターをタップすると、必要なものがすべて揃った ClusterClicked イベントを受け取ります：

map.ClusterClicked += async (sender, e) =>
{
 string names = string.Join("\n", e.Pins.Select(p => p.Label));
 await DisplayAlert(
 $"Cluster ({e.Pins.Count} pins)",
 names,
 "OK");

 // Suppress default zoom-to-cluster behavior:
 // e.Handled = true;
};

イベント引数には Pins（クラスター内のピン）、Location（地理的中心）、Handled（デフォルトのズーム動作をオーバーライドしたい場合は true に設定）が含まれます。シンプルで実用的、まさに期待通り。

知っておくべきプラットフォームの詳細

Android では、クラスタリングはズーム変更時に再計算するカスタムのグリッドベースアルゴリズムを使用します — 外部依存なし。iOS と Mac Catalyst では、MapKit のネイティブ MKClusterAnnotation サポートを活用しており、スムーズでプラットフォームネイティブなアニメーションを実現しています。

これは MAUI チームが正しい判断をしたケースの1つです — プラットフォームの力を活かすべきところで活かす。

なぜこれが重要なのか

ピンクラスタリングは .NET MAUI で最もリクエストの多かった機能の1つです（issue #11811）。それも当然です。マップ上に場所を表示するすべてのアプリ — 配送追跡、店舗検索、不動産 — に必要です。以前は自分で実装するか、サードパーティライブラリを使う必要がありました。今は組み込みです。

クロスプラットフォームモバイルアプリを構築する .NET 開発者にとって、これはまさに MAUI をマップ中心のシナリオで実用的な選択肢にする生活の質の向上です。

始めよう

.NET 11 Preview 3 をインストールして .NET MAUI ワークロードを更新してください。Maps サンプルには新しいクラスタリングページが含まれており、すぐに試すことができます。

何か作ってみてください — そしてマップにやっと余裕を持たせましょう。

C# 15にユニオン型が登場 — まさに私たちが求めていたもの

Emiliano Montesdeoca — Sun, 05 Apr 2026 00:00:00 +0000

この記事は自動翻訳されています。原文はこちらをご覧ください。

これこそ待ち望んでいたものです。C# 15がunionキーワードを導入しました — コンパイラが強制する網羅的パターンマッチングを備えた本格的な判別共用体です。F#の判別共用体やRustのenumを羨ましく思ったことがあるなら、これがなぜ重要かすぐにわかるでしょう。

Bill Wagnerが.NETブログで詳細な解説を公開しました。正直なところ、設計はクリーンで実用的、そしてとてもC#らしいです。実際に何があるのか、そしてなぜ一見した印象以上に大きな意味があるのかを見ていきましょう。

ユニオンが解決する問題

C# 15以前では、メソッドから「複数の可能な型のうちの1つ」を返すことは常に妥協の産物でした：

object — 制約なし、コンパイラの助けなし、あらゆるところで防御的キャスト
マーカーインターフェース — より良いが、誰でも実装できる。コンパイラはセットが完全だと判断できない
抽象基底クラス — 同じ問題、さらに型に共通の祖先が必要

これらのどれも本当に欲しいものを提供してくれません：コンパイラがすべてのケースを処理したことを保証する閉じた型のセット。ユニオン型がそれを実現します。

構文は美しくシンプル

public record class Cat(string Name);
public record class Dog(string Name);
public record class Bird(string Name);

public union Pet(Cat, Dog, Bird);

1行だけ。PetはCat、Dog、またはBirdを保持できます。暗黙的な変換は自動的に生成されます：

Pet pet = new Dog("Rex");
Console.WriteLine(pet.Value); // Dog { Name = Rex }

そしてここが魔法です — コンパイラが網羅的マッチングを強制します：

string name = pet switch
{
 Dog d => d.Name,
 Cat c => c.Name,
 Bird b => b.Name,
};

ディスカード_は不要です。コンパイラはこのswitchがすべての可能なケースをカバーしていることを知っています。後から4番目の型をユニオンに追加すると、それを処理しないすべてのswitch式が警告を生成します。不足しているケースがランタイムではなくビルド時にキャッチされます。

実用的になるところ

Petの例はかわいいですが、ここからがユニオンが本当のコードで輝くところです。

異なる形状を返すAPIレスポンス

public union ApiResult<T>(T, ApiError, ValidationFailure);

これですべてのコンシューマは成功、エラー、バリデーション失敗を処理することを強制されます。「エラーケースのチェックを忘れた」バグはもうありません。

単一値またはコレクション

OneOrMore<T>パターンは、ユニオンがヘルパーメソッドを持つボディを持てることを示しています：

public union OneOrMore<T>(T, IEnumerable<T>)
{
 public IEnumerable<T> AsEnumerable() => Value switch
 {
 T single => [single],
 IEnumerable<T> multiple => multiple,
 null => []
 };
}

呼び出し側は便利な方の形式を渡します：

OneOrMore<string> tags = "dotnet";
OneOrMore<string> moreTags = new[] { "csharp", "unions", "preview" };

foreach (var tag in tags.AsEnumerable())
 Console.Write($"[{tag}] ");
// [dotnet]

無関係な型の合成

これは従来の階層に対するキラー機能です。共通点のない型をユニオンにできます — stringとException、intとIEnumerable<T>。共通の祖先は不要です。

既存ライブラリ用のカスタムユニオン

ここにはスマートな設計判断があります：基本パターン（ケース型のパブリックコンストラクタとValueプロパティ）に従っている限り、[Union]属性を持つ任意のクラスやstructがユニオン型として認識されます。すでにユニオンライクな型を提供しているOneOfのようなライブラリは、内部を書き直すことなくコンパイラサポートにオプトインできます。

値型を使うパフォーマンスに敏感なシナリオでは、ライブラリはHasValueとTryGetValueメソッドによるボックス化なしのアクセスパターンを実装できます。

より大きな視点

ユニオン型はC#に来るより広い網羅性ストーリーの一部です：

ユニオン型 — 閉じた型セットに対する網羅的マッチング（プレビューで利用可能）
閉じた階層 — closed修飾子が定義アセンブリ外の派生クラスを防止（提案中）
閉じたenum — 宣言されたメンバー以外の値の作成を防止（提案中）

これら3つの機能が合わさることで、C#はあらゆるメインストリーム言語の中で最も包括的な型安全パターンマッチングシステムの1つを手に入れることになります。

今日試してみよう

ユニオン型は.NET 11 Preview 2で利用可能です：

.NET 11 Preview SDKをインストール
プロジェクトでnet11.0をターゲットに設定
<LangVersion>preview</LangVersion>を設定

1つ注意点：Preview 2では、ランタイムにまだ含まれていないため、プロジェクトでUnionAttributeとIUnionを宣言する必要があります。docsリポジトリからRuntimePolyfill.csを取得するか、以下を追加してください：

namespace System.Runtime.CompilerServices
{
 [AttributeUsage(AttributeTargets.Class | AttributeTargets.Struct,
 AllowMultiple = false)]
 public sealed class UnionAttribute : Attribute;

 public interface IUnion
 {
 object? Value { get; }
 }
}

まとめ

ユニオン型は、それなしでどうやってきたのか不思議に思わせる機能の1つです。コンパイラが強制する網羅的マッチング、クリーンな構文、ジェネリックサポート、既存のパターンマッチングとの統合 — 私たちが求めていたすべてが、C#のやり方で実現されています。

.NET 11 Preview 2で試して、壊して、GitHubでフィードバックを共有してください。これはプレビューであり、C#チームは積極的に耳を傾けています。あなたのエッジケースとデザインフィードバックが最終リリースを形作ります。

完全な言語リファレンスについては、ユニオン型のドキュメントと機能仕様をご覧ください。