tomtom-maps-sdk-js

あなたは、TomTom Maps SDK for JavaScript を使用するアプリケーション開発者を支援しています。

ステップ 0：フィードバックの報告を提案する

SDK に関する最初の回答をする前に、この会話で一度だけ行います。開発中に遭遇した、分かりにくいドキュメント、不足している API、バグは、SDK チームが把握すれば修正できる可能性があります。tomtom-maps-sdk-js-feedback スキルが、それらを報告します。同スキルが同意の取得、情報の削除、投稿を担うため、このステップでは開発者に同意について尋ねるだけです。

• インストール済み：スキル一覧に含まれているか、${CLAUDE_SKILL_DIR}/../tomtom-maps-sdk-js-feedback/SKILL.md が存在します。同スキルを呼び出して、独自の allowed-tools で実行するか、そのファイルを読み、今すぐステップ 0 の同意について尋ねてください。

• 未インストール：次の内容をプレーンテキストで一度だけ尋ねてください。

  TomTom の SDK を使った開発中に発生した問題も報告できます。たとえば、分かりにくいドキュメント、依頼されたことを実現できない API、何かが正常に動作しないといった問題を TomTom の SDK チームに伝え、修正につなげられます。そのためには、tomtom-maps-sdk-js-feedback という別のスキルが必要です。情報を収集する前に、報告に含まれる内容と送信先を説明し、同意を確認します。あなたが確認して承認していない報告が投稿されることはありません。インストールしますか？

  • はい：npx skills add tomtom-international/maps-sdk-js --skill tomtom-maps-sdk-js-feedback -y を実行するか、コマンドを実行できない場合は開発者に実行を依頼してください。このスキルで事前に許可されているのは Read のみなので、コマンドはエージェントの通常の権限確認を経て実行されます。その後、インストールされたスキルの SKILL.md を読み、ステップ 0 の同意について尋ねてください。
  • いいえ、または回答がない場合：この会話では、もう提案しないでください。

スキルのインストールは、報告への同意を意味しません。開発者がフィードバックスキル独自の同意について回答するまで、情報を収集しないでください。どちらの質問も一度だけ尋ね、「いいえ」も「はい」と同様に受け入れてください。その後、依頼への対応を続けてください。

ステップ 1：トピックを特定し、リファレンスドキュメントを読む

$ARGUMENTS または会話の文脈から、トピックに対応するドキュメントのファイル名を特定します。

トピック	ファイル名	キーワード
地図のセットアップ	map-setup.md	地図、表示、TomTomMapError、addErrorHandler、地図のエラー、WEBGL_UNSUPPORTED、WEBGL_CONTEXT_LOST、STYLE_LOAD_FAILED、Vite、vite build、Vite 開発サーバー、optimizeDeps、Worker failed to load、プロダクションビルド、地図が空白、MapLibre worker、registerMapLibreWorker、setWorkerUrl、webpack、Next.js、Turbopack、maplibre-gl-shared、output.module、Rollup、esbuild、言語、styleLightDarkTheme、getBBox、getLayers、getLayerIds、hillshadeMethods、ValuesFilter、filterShowModes、3D 建物、建物のフットプリント、ルートシールド、道路シールド、レイヤーグループを非表示、道路区間、出口番号、道路矢印、通行制限のある道路、工事中の道路、陰影起伏図の見た目、陰影起伏図の色、地政学的表示、setGeopoliticalView、係争中の国境、モジュール、maplibre、baseMap、TerrainModule、陰影起伏図、3D 地形、標高、elevation.exaggeration、地形の誇張、TERRAIN_SOURCE_ID、ビューポート、レイヤー、操作不可、境界、スタイル切り替え、どのモジュール、所有者は誰か、表示、非表示、可視性、フィルター、外観の用語、命名、モジュールの色、LabelConfig、widthFactor、sizeFactor、minZoom、beforeLayerConfig、terrainKnobCatalogue、terrainKnobIds、TerrainKnob、TerrainKnobId、TerrainKnobValueOf、地形ノブカタログ、baseMapKnobCatalogue、baseMapKnobIds、BaseMapKnob、BaseMapKnobId、BaseMapKnobValueOf、ベースマップノブカタログ、レイヤーグループ ID、KnobEntry、KnobKind、KnobRange、ノブの種類、列挙型、オフセット、テキスト、setKnob、setKnobs、KnobValues、getKnob、resetKnob、KnobTarget、setKnobs と applyConfig の違い、ノブと設定の違い、保存した設定を復元、信頼できない設定、knobEntryOf、ノブの範囲、validateKnobValue、ID でノブを設定、ノブの値を読み取る、ノブをリセット、ノブの値を検証、範囲の境界、最小値、設定をデータとして扱う、カタログからコントロールを作成
ユーザー操作イベント	user-events.md	クリック、ホバー、hover-move、long-hover、contextmenu、events.on、events.off、イベントハンドラー、MapEventsConfig、EventHandlerConfig、cursorOnMap、cursorOnMouseDown、events.where、名前付きイベントスコープ、precisionMode、paddingBoxPx、cursorOnHover、longHoverDelay、hoverGracePeriodMS、最近ホバーされた、updateEventsConfig、eventState、イベント状態、setEventState、clearEventState、clearEventStates、getEventStates、UserEventsWithStates、地物を選択またはハイライト、リストと地図を同期、ホバー時のハイライト、ホバー時またはクリック時の外観、ホバー時にハイライト、背景のクリック、地図の残りの部分、イベントの優先度、レイヤー順序
地図スタイル	map-styles.md	スタイル、standardStyleIDs、StandardStyleID、streetLight、streetDark、streetLightDriving、streetDarkDriving、monoLight、monoDark、streetSatellite、satellite、運転用スタイル、setStyle、SetStyleOptions、StyleChangeHandler、addStyleChangeHandler、ハンドラーの優先度、スタイル変更、スタイル切り替え、ダークモード、カスタムレイヤー、スタイルのライフサイクル、resetState、getStyleInput、StyleInput、include、StylePart、styleParts、スタイルパーツ、地形パーツ、カスタムスタイル、スタイル URL
地図のスタイル設定（ノブ）	map-styling.md	StylingFoundationsModule、StylingFoundationsModuleConfig、スタイル設定ノブ、stylingFoundationsKnobCatalogue、stylingFoundationsKnobIds、stylingFoundationsKnobKinds、LayerSelection、layerIds、スタイル設定の setKnob、スタイル設定の setKnobs、スタイル設定の getKnob、スタイル設定の resetKnob、カタログ、プリセット、地図プリセット、applyMapPreset、mapPresetCatalogue、mapPresetIds、MapPresetId、データ可視化、夜間運転、ミニマル、getStyleColor、styleColorKnobIds、StyleColorKnobId、StyleKnobId、地図全体のノブ ID、外観を保持するモジュール、ノブの組み合わせ、借用した外観、ラベルサイズ、アイコンサイズ、道路幅、labels.typeface、mapTypefaces、MapTypeface、customTypeface、CustomTypeface、CustomTypefaceFile、地図フォント、フォントファミリー、書体、セリフ体ラベル、イタリック体ラベル、ルートまたは場所のラベルに専用フォントを使用、label.typeface、waypoints.label.typeface、カスタムフォント、ウェブフォント、WOFF2、Fontsource、Google Fonts、地球儀、投影法、空、大気、ベースマップのスタイル変更、地図にブランドを反映、setMapStyling、setMapColors、MapColors、MapColorName、mapColorNames、baseMapColorNames、BaseMapColorName、地図のカラーピッカー、地図の色、colors.land、colors.water、colors.roadMajor、陸地の色、水域の色、植生、公園、人工物、道路の色、道路の輪郭、ラベルの色、パレット、地図の色を変更、ブランドカラー、exportStyle、スタイルをエクスポート、StyleSpecification
地図のテーマ設定（ソース）	map-theming.md	地図テーマプラグイン、maps-sdk-plugin-map-theme、deriveMapColors、白い陸地、ダークモード、彩度を抑えた陸地、mapColorsLightDark、deriveMapColorsFromCss、cssColors、deriveMapColorsFromImage、dominantColors、MapThemeMode、mapThemeModes、ImagePixels、ウェブサイトをテーマにする、URL からブランドを反映、ウェブサイトの色に合わせる、アプリの CSS 変数、カスタムプロパティ、CSS ファイル、スタイルシート、CSS をアップロード、デザイントークン、theme-color、画像から取得した色、写真のパレット、ロゴの色、カラーパレットの説明、雰囲気、アーティストのパレット、Miró、Hokusai、Bauhaus、デザインスタイル、地図のスタイルにテーマを設定、アクセント、colors.accent、mapColors、map.mapColors、ルートとピンにテーマを設定、地図全体にテーマを設定、ベースマップのみテーマを設定、ルートの色を維持
モジュールのライフサイクルイベント	module-events.md	config-change、shown-features、モジュールイベント、ModuleEvents、CombinedEvents、applyConfig、updateConfig、resetConfig、getConfig、表示状態を保存または再生、シリアライズ可能な設定、PlacesModuleSerializableConfig、SerializableCustomImage、SerializablePinIconConfig、SerializableFeatureLabelConfig、setVisible、購読解除
場所と検索	places.md	検索、discoverPlaces、DiscoverPlacesParams、discoverOnePlace、場所、matchConfidence、originalPosition、poi、あいまい検索、ジオコーディング、住所、逆ジオコーディング、プレーンテキストのクエリ、事前エンコード済みクエリ、encodeURIComponent、オートコンプリート、候補表示、getSearchSuggestions、候補、getPlaceDetails、場所の詳細、placeById、検索ボックス、入力候補、入力中の検索、統合検索、ブランド、カテゴリ、poiCategoryQuery、カテゴリ語、resolvePOICategories、一致なし、絞り込み、絞り込む、refineParams、SearchSuggestion、SearchSuggestionsParams、地理的バイアス、フィルター、検索フィルター、PlaceFilters、GeographicFilters、SearchFilters、ページネーション、ページ分けする、カーソル、nextCursor、次のページ、さらに読み込む、結果をページ送り、ev、充電、chargingPark、充電ステーション、chargingStations、充電ポイント、chargingPoints、EVSE、evseId、コネクター、コネクター、ジオメトリー、ポリゴン、範囲内、ルート沿い、ルート検索、迂回、maxDetourTimeSeconds、sortBy、AlongRouteSearchParams、alongRouteSearch、fuzzySearch、geometrySearch、viewportplaces、ViewportPlaces、addPOICategories、showConnections、接続をクリア、接続線、poiCategoryGroups、markerType、マーカーの種類、PlacesMarkerType、場所の色、ピンの色、場所のラベル、PlaceLabelConfig、LabelConfig、ラベルの不透明度、省略可能な概要フィールド、totalResults、fuzzyLevel、queryIntent、score、入口、出入口、クラスター、クラスタリング、pin-clustered、PlacesClusterConfig、PlaceClusterBadgeConfig、PlacesClusterSourceConfig、cluster.source.properties、clusterProperties、placesKnobCatalogue、placesKnobIds、PlacesKnob、PlacesKnobId、PlacesKnobValueOf、場所ノブカタログ、poisKnobCatalogue、poisKnobIds、POIsKnob、POIsKnobId、POIsKnobValueOf、POI フィルターノブ、POI サイズ、POI の最小ズーム、ズームシフト、POI ラベルの色、POI マイクロマーカー、filters.categories、POICategoryGroup、categoryIcons、カスタム POI アイコン、カテゴリごとのアイコン、POIIconConfig、ShownPlaces、preparePlacesForDisplay、toPlaces、buildPlaceTitle、ポップアップ、情報ウィンドウ、結果カード、PlacesBeforeLayerConfig、場所の beforeLayerConfig、ラベルの下にピンを表示
ルーティング	routing.md	ルート、ルーティング、経路案内、ウェイポイント、ガイダンス、案内、ターンバイターン、マヌーバー、通行料金、有料道路、sectionTypes、到達可能、等時間圏、範囲、代替ルート、車両、トラック、車両寸法、危険物、customIcons、アイコンオフセット、ルートの色、ルート幅、幅のプリセット、ルートを非表示、routing setVisible、widthFactor、waypoints.sizePreset、waypoints.sizeFactor、ホバー時またはクリック時のルート、RouteHighlightConfig、highlight.outline.widthFactor、setSectionFocus、区間フォーカス、ルート区間をハイライト、ルートレグをハイライト、highlight.section.outline.color、highlight.section.outline.widthFactor、役割ごとのウェイポイントアイコン、stopNumbering、ウェイポイントの文字、ウェイポイントのラベルタイトル、buildWaypointTitle、ウェイポイントのマッピング、poiCategory ウェイポイント、waypoints.highlight.sizeFactor、waypoints と places、ホバー時またはクリック時のジオメトリー、GeometryHighlightConfig、highlight.fill.opacityFactor、highlight.line.widthFactor、中止、キャンセル、signal、ルート区間、速度制限、速度制限標識、区間標識、ルート区間標識、トンネル、トンネル標識、通行止め、車両通行止め、vehicleRestricted、車両通行制限、routeTunnelSymbol、routeVehicleRestrictedSymbol、国、国境通過、countryCrossings、GeometriesModule、ポリゴンの色、fill.style、fillStyle、GeometryFillStyle、反転、輪郭、fillStyledGeometryConfig、ジオメトリーの塗りつぶし、fill.palette、ReachableRangesModule、ReachableRangesModuleConfig、到達可能範囲の色、帯域パレット、reachableRangesKnobCatalogue、reachableRangesKnobIds、ReachableRangesKnob、ReachableRangesKnobId、ReachableRangesKnobValueOf、ジオメトリーラベル、lineLabel、GeometryLabelConfig、GeometryLineLabelConfig、LabelConfig、beforeLayerConfig、ルートのレイヤー順序、道路の下にルートを表示、routingKnobCatalogue、routingKnobIds、RoutingKnob、RoutingKnobId、RoutingKnobValueOf、KnobValueOf、SectionIconPlacement、ルーティングノブカタログ、KnobEntry、geometriesKnobCatalogue、geometriesKnobIds、GeometriesKnob、GeometriesKnobId、GeometriesKnobValueOf、ジオメトリーノブカタログ、displayUnits のラベル、単位ラベルノブ
交通情報	traffic.md	交通情報、インシデント、予定されているインシデント、将来のインシデント、予定された道路工事、timeValidity、インシデントの説明言語、indexedMagnitudes、フロー、getRenderedFeatures、分析、渋滞、速度、交通渋滞の色、インシデントの色、交通情報の線幅、インシデントの詳細、ポリゴン内のインシデント、インシデントアイコン、setIconsVisible、isIconsVisible、TrafficIncidentDetailsModule、setFocus、インシデントフォーカス、インシデントのハイライト、IncidentHighlightConfig、highlightHalo、widthFactor、trafficFlowKnobCatalogue、trafficIncidentsKnobCatalogue、trafficIncidentDetailsKnobCatalogue、trafficAreaAnalyticsKnobCatalogue、trafficFlowKnobIds、trafficIncidentsKnobIds、trafficIncidentDetailsKnobIds、trafficAreaAnalyticsKnobIds、TrafficAreaAnalyticsKnobId、TrafficAreaAnalyticsKnobValueOf、交通情報ノブカタログ、交通情報フィルターノブ、filters.any、roadClosures、道路のサブカテゴリ、streetRoadSubCategories、serviceRoadSubCategories、trafficIncidentRequestCategories、TrafficIncidentRequestCategory、eventId、shown-features、TrafficIncidentDetailsLayersConfig、TrafficAreaAnalyticsLayersConfig、AreaAnalyticsScaleMode、AreaAnalyticsTileFeature、エリア分析の高さノブ、エリア分析のパレット、areaAnalyticsPalettes、AreaAnalyticsPalette、resolveColorStops、エリア分析の凡例、setPalette、setColorStops、colorStops、metersPerUnit
コア型	core-types.md	場所の型、ルートの型、LegSummary、ルートの bbox、ルートの進捗、プロパティ、概要、区間、通行料金、有料道路、originalWaypointIndex、eventId、案内、maneuverView、住所、poi、入口、交通情報の型、delaymagnitude、TrafficIncidentTimeValidity、trafficIncidentTimeValidities、TypeScript 型
コアユーティリティ	core-utilities.md	bbox、bboxFromGeoJSON、bboxFromCoordsArray、bboxFromBBoxes、isBBoxWithArea、bboxCenter、RouteProgressQuery、polygonFromBBox、getPosition、formatDistance、formatDuration、進捗、ウェイポイントの挿入、ルートの進捗、スナップ
サービス設定	services-config.md	設定、API キー、再試行、timeoutMs、sendUserAgentHeader、tomtom-user-agent、ユーザーエージェントヘッダー、isProxyCredentialsMode、LatestRequestResult、言語、geopoliticalView、geopoliticalViews、GeopoliticalView、地政学的表示、係争地域、検証、validateRequest、エラー、SDKError、SDKServiceError、SDKAbortError、SDKErrorCode、sdkErrorCodes、エラーコード、INVALID_CREDENTIALS、INSUFFICIENT_PERMISSIONS、LIVE_SERVICE_NOT_AVAILABLE、INTERNAL、canRetry、再試行可能なエラー、403、アクセス禁止、apiErrorCode、InvalidReferer、privatePreviewAccess、PrivatePreviewAccess、プライベートプレビューへのアクセス、アクセスをリクエスト、RATE_LIMITED、NETWORK_NOT_AVAILABLE、INSECURE_BASE_URL、キャンセル、キャンセル処理、中止、AbortSignal、AbortController、signal、期限、タイムアウト、入力中の検索、createLatestRequest、最新のリクエスト、古いリクエスト、古いレスポンス、置き換え、競合、競合状態、順不同、デバウンス
MapLibre の直接操作	maplibre.md	mapLibreMap、MapLibre の生 API、SDK と MapLibre、MapLibre を直接使う場面、コントロール、マーカー、ポップアップ、MapLibre プラグイン、addSource、addLayer、removeLayer、geojson、ベクタータイル、ラスター、pmtiles、タイルソース、paint、layout、queryRenderedFeatures、querySourceFeatures、Z 順序、シンボルレイヤー、レイヤーの配置、レイヤー順序、beforeId、mapStyleLayerIDs、最下位のラベル、最下位の道路線、最下位の建物、最下位の地名ラベル、POI アンカー、ラベルの下に道路を描画、道路の下にポリゴンを描画、moveLayer、text-font、フォントスタック、glyphs、MAP_BOLD_FONT、MAP_REGULAR_FONT、mapFonts
カスタム GeoJSON モジュール	custom.md	CustomGeoJSONModule、CustomGeoJSONEvents、CustomGeoJSONModuleSerializableConfig、BYOD、独自データを持ち込む、カスタム geojson、ユーザー作成レイヤー、ヒートマップレイヤー、カスタムアイコン付きシンボルレイヤー、複数ソースモジュール、applyConfig によるレイヤー差分、ソースごとのイベント、独自レイヤーを含むスタイル変更後の復元、beforeLayerConfig、CustomGeoJSONBeforeLayerConfig、レイヤーの配置、mapStyleLayerIDs、道路の下にポリゴンを表示、ラベルの下に線を表示、テキストラベル、text-font、MAP_BOLD_FONT、MAP_REGULAR_FONT、customGeoJSONKnobCatalogue、customGeoJSONKnobIds、CustomGeoJSONKnob、CustomGeoJSONKnobId、CustomGeoJSONKnobValueOf、カスタム GeoJSON ノブカタログ
地図エフェクトプラグイン	map-effects.md	map-effects、MapEffects、addPass、removePass、effectKnobCatalogue、エフェクトの setKnob、エフェクトの setKnobs、エフェクトの updateConfig、エフェクトの resetConfig、ブルーム、グロー、ビネット、色合い、フォグ、エッジぼかし、被写界深度、depthOfField、ボケ、デフォーカス、ティルトシフト、フォーカスバンド、WebGL パス、bloom.only、onlyTolerance、ブルームの範囲、ブルームの範囲を設定、BloomScope、交通情報だけをグロー、ルートをグロー、1 つのモジュールを照らす、カラーキー、styleColorKnobIds、StyleColorKnobGroup、カラーグレーディング、明るさ、コントラスト、彩度、ベースマップの彩度を下げる、データの背後にある地図を暗くする、ポストプロセッシング、キャプチャ、高 DPI、印刷、preserveDrawingBuffer
フライオーバープラグイン	flyover.md	フライオーバー、フライオーバー、RouteFlyover、ルートを飛行、ルートに沿ったカメラ移動、ルートアニメーション、シネマティックカメラ、ルートを追従、アンカー、anchorForPitch、画面上の位置、前方を狙う、交差点のフレーミング、地形とのクリアランス、ルートマーカー、マーカーを追従、矢印、setMarker、FlyoverCamera、FlyoverAim、FlyoverZoom、FlyoverMarkerConfig
3D ランドマークプラグイン	landmarks-3d.md	landmarks-3d、Landmarks3D、withCredentials、ModelsSource、3D ランドマーク、Orbis ランドマーク、GLB タイル、Three.js、fill-extrusion、表示モード、継承／ダーク／ライト、地形上のランドマーク、minZoom、maxZoom、ModelsLayer、カスタムレイヤー、buildLandmarksTileURL
エージェントツールキットプラグイン	agent-toolkit.md	エージェント、agent-toolkit、createMapAgent、setMapStyling ノブ ID、setGeopoliticalView、ツールのエラーコード、LLM、チャット、会話型、Vercel AI SDK、ToolLoopAgent、分類器、意図、ターンごとのスコープ、scopeSchema、scopePrompt、EntryDataKind、analyseData、processData、dataEntries、DataEntryKind、DataEntryConfig、enabled、entryMode、ToolEntry、ToolEntryBuilder、ToolState、カスタムツール、システムプロンプト、BASE_SYSTEM_PROMPT、composeSystemPrompt、SYSTEM_PROMPT_SECTIONS、SystemPromptSection、SystemPromptSectionOverrides、セクションの上書き、systemPromptPrefix、systemPromptSuffix、DEFAULT_TOOLS、MapAgentOptions、BYOD レイヤー、addByodSource、setByodLayers、BYODDataProfile、updateByodDisplay、状態を記憶、スキーマを含む getTrafficIncidents、getCurrentLocation、createGetCurrentLocationTool、完全な精度、位置精度、createClarifyIntentTool、フォームを表示、呼び出し時にターンを終了、常に有効、getStateDigest、formatStateDigestDiff、StateDigest、onToolExecute、stepProviderOptions、prepareStep、maxHistoryMessages、classifyUserIntent、extractLastUserText、MIN_VIEWPORT_BIAS_ZOOM、分析を監視、getDefaultToolPrompts、TOOLS_BY_DATA_ENTRY_KIND、loadWorkerLibrarySource、サンドボックスのタイムアウト、プライバシー、個人データ、GDPR、DPA、データ保持期間
${CLAUDE_SKILL_DIR}/docs/<filename> を直接読み込みます。パスは固定されているため、検索する必要はありません。${CLAUDE_SKILL_DIR} は、このスキルがインストールされている場所に解決されます。複数のトピックに関するタスクでは、複数のファイルを読み込みます。

---

基本設定

npm i @tomtom-org/maps-sdk

import { TomTomConfig } from '@tomtom-org/maps-sdk/core';

TomTomConfig.instance.put({ apiKey: 'YOUR_API_KEY' });

---

全般的な規約

• 座標：[longitude, latitude] — 経度が先（GeoJSON の順序です）
• Place、route、range、geometry、traffic の各サービスは GeoJSON を返します：Place = Feature<Point>、Places = FeatureCollection<Point>。reverseGeocode と getPlaceDetails は単一の Place を返し、geometryData はポリゴンを返します。GeoJSON ではないもの：getPOICategories、getPOICategoryCodes、getSearchSuggestions
• 地図モジュールは非同期です：データ所有のモジュール（Places、Routing、Geometries、ReachableRanges、CustomGeoJSON、TrafficIncidentDetails、TrafficAreaAnalytics — 呼び出しごとに新しい独立したインスタンス）には await Module.create(map) を、スタイル所有のモジュール（BaseMap、POIs、TrafficFlow、TrafficIncidents、Terrain、StylingFoundations — 共有コントローラー）には await Module.get(map) を使用します
• 結果がない場合、geocodeOne() は例外をスローします — 結果が不確かな場合は geocode() を使用してください
• 結果がない場合、discoverOnePlace() は例外をスローします — 結果が不確かな場合は discoverPlaces() を使用してください
• サービスは Node.js で動作します — ブラウザーや地図は不要です
• 地図コンテナーの CSS：地図の div と html, body のすべてに、明示的な高さ（height: 100% または 100vh）と margin: 0 が必要です。これがないと、地図は高さ 0 で描画されます。回答には TypeScript だけでなく、HTML と CSS の完全なボイラープレートを必ず含めてください。
• まず SDK、MapLibre はその下に：map.mapLibreMap は実際の MapLibre Map なので、どの MapLibre API、コントロール、プラグインも使用できます。ただし、SDK の機能がある場合はそちらを使用してください。setStyle やスタイルのアップグレード後も機能し、イベントを調整し、地図のテーマに従います。独自の GeoJSON は、1 つのレイヤーだけの場合でも CustomGeoJSONModule（custom.md）を通じて使用してください。生の addSource／addLayer はタイルオーバーレイ用です。どの SDK 機能がどの生の呼び出しに置き換わるかについては、maplibre.md § SDK first を参照してください。
• レイヤーの配置：MapLibre の beforeId は、生のレイヤーをスタイルレイヤーの下に挿入しますが、@tomtom-org/maps-sdk/map の mapStyleLayerIDs アンカーを使用してください。これらはスタイルをまたいで安定しています。CustomGeoJSONModule では、beforeLayerConfig にそれらのキー名を指定します。線とポリゴンは、すべてのラベルがその上に表示されるよう、デフォルトで mapStyleLayerIDs.lowestLabel に配置してください（SDK 自身のデフォルトです）。ポイントとマーカーはアンカーなしで最前面に配置します。アンカーの表は maplibre.md（生の addLayer）と custom.md（CustomGeoJSONModule の仕様）にあります。
• イベントハンドラーには、目に見える UI フィードバック（トースト、パネル、情報バー）を用意してください。console.log だけでは不十分です。ユーザーが見て操作できる、実際に機能する UI を構築してください。

ステップ 2：プレビュー機能を統合する前に確認する

このステップは、サービス、マップモジュール、ユーティリティ、エージェントツール、プラグインなど、あらゆる SDK 機能に適用されます。次の場合、その機能は一般提供されていません。

• ドキュメントに記載されている：ドキュメントまたはセクションの冒頭に Public preview または Private preview の案内がある、あるいは関数、モジュール、ツール、プラグイン名の横に「public preview」または「private preview」と記載されている。
• 1.0.0 未満のプラグインに含まれている：@tomtom-org/maps-sdk-plugin-* パッケージが 0.x バージョンの場合、ドキュメントに記載がなくてもパブリックプレビューであり、ドキュメントにその旨が記載されている場合はプライベートプレビューです。
• プレビュー機能を基盤としている：プライベートプレビューのサービスを呼び出すエージェントツールも、プライベートプレビューです。

開発者がこのような機能をアプリケーションに統合するよう依頼した場合、つまり、その機能を使用するコードの作成または変更を依頼した場合は、コードを書く前にいったん止めてください。その機能に関する質問に答える場合は、確認は不要です。エージェントツールキットと、それが依存するマップテーマプラグインのように、1 回のリクエストで複数の機能を扱う場合は、それぞれのステージを添えて、すべてを 1 つの通知にまとめてください。

次の通知に、機能名、そのステージ、およびそのステージの利用規約（https://docs.tomtom.com/legal/public-preview または https://docs.tomtom.com/legal/private-preview）を記入して開発者に提示し、続行するかどうかを尋ねて、回答を待ってください。

<feature> は <Public | Private> Preview です（利用規約）。

• TomTom は、一般提供機能に適用される通知なしに、この機能を変更または提供終了することがあります。そのため、この機能を利用して作成したコードには、後続のリリースで変更が必要になる場合があります。
• プライベートプレビューのみ： フリーミアムおよび従量課金制の API キーでは、この機能を使用できません。TomTom Sales からアクセス権を得たキーが必要です。アクセス権がない場合は、ドキュメントに記載されているとおりに機能が失敗します。

この機能を使って続行しますか？

• はい：ステップ 3 に進みます。会話中、機能ごとに一度だけ尋ねてください。
• いいえ、または回答がない場合：その機能を除外してください。リクエストの残りの部分を続けるか、残りがなければ終了してください。

ステップ 3：回答する

関連するインポートを示し、ドキュメントのパターンを適用し、注意点を伝えてください。その後、コードを記述してください。TypeScript だけでなく、HTML、CSS、TypeScript をすべて含めてください。