地図コンポーネント
目次
円
円コンポーネントは、緯度と経度で、指定された半径の円をメートル単位で視覚化します。 円の外観は、 塗りつぶし色、ストロークカラー 、 ストローク幅などのプロパティを使用してカスタマイズできます
円コンポーネントは、ジオフェンシング、ある領域内でのユーザーの存在が他の動作を引き起こすために使用されるメカニズムなどの機能を実装するためにも使用できます。 “ポイント（点）までの距離"メソッドを位置センサーと組み合わせて使用すると、ユーザーの位置が円の内側か外側かを判断できます。 この機能を使用して追加のアクションを起動することができます
プロパティ
説明: 情報ウィンドウに表示される説明を設定または取得します。 ユーザーが円をタップすると情報ウィンドウが表示されます
ドラッグ可能: ユーザーが地図フィーチャーをドラッグできるかどうかを設定または取得します。 この機能にアクセスするには、長押しして円を新しい場所にドラッグします
有効化インフォボックス: ユーザーが円をタップしたときのインフォボックスウィンドウの表示を有効または無効にします
塗りつぶし色: 円を塗りつぶすために使用される色を設定または取得します
塗りつぶしの不透明度: 円を塗りつぶす色の不透明度を設定または取得します。0.0を指定すると完全に見えなくなり、1.0を指定すると完全に不透明になります
緯度: 円の中心の緯度を度数で設定または取得します。 赤道の北を表す正の値と赤道の南を表す負の値。 緯度と経度を同時に更新するには、 “ロケーション設定"メソッドを使用します
経度: 円の中心の経度を度数で設定または取得します。 子午線の東を表す正の値と子午線の西を表す負の値。 緯度と経度を同時に更新するには、 “ロケーション設定"メソッドを使用します
半径: 円の半径をメートル単位で設定または取得します
ストロークカラー: 円の輪郭を描くのに使う色を設定または取得します
ストローク不透明度: 円の輪郭の不透明度を設定または取得します。0.0を指定すると完全に見えなくなり、1.0を指定すると完全に不透明になります
ストローク幅: 円の輪郭を描くために使用されるストロークの幅を設定または取得します
タイトル: ユーザーが地図フィーチャーをクリックしたときに表示される情報ウィンドウに表示されるタイトルを設定または取得します
タイプ: 機能の種類を取得します。 円の場合、これは常に “円"になります
目に見える: 画面に表示するかどうかを設定または取得します。 表示されている場合は値は真、非表示になっている場合は偽です
イベント
クリックされたら(): ユーザーが円をタップしたときに実行されます
ドラッグされたら(): ドラッグ操作中に実行されます
長押しされたら(): ユーザーが円を長押しして離したときに実行されます。 このイベントはドラッグ可能プロパティが偽の場合にのみトリガーされることに注意してください
ドラッグが始まったら(): このイベントは、ユーザーが円を押し続け、画面上で指を動かすときに実行されます。続いて、"ドラッグされたら"イベントと"ドラッグが終わったら"イベントが実行されます
ドラッグが終わったら(): このイベントは、ドラッグ終了時にユーザーが円を離すと実行されます
メソッド
フィーチャーまでの距離(地図フィーチャー, 重心): 円と指定されたフィーチャーの間の距離を計算します。 重心が真の場合、計算は2つのフィーチャーの重心間で行われます。 それ以外の場合は、最も近い点に基づいて2つのフィーチャ間の距離が計算されます。 さらに、 重心フィーチャーと交差するか含まれる場合、このメソッドは0を返します。 エラーが発生した場合、このメソッドは-1を返します
ポイント（点）までの距離(緯度、経度、重心): 円と指定された緯度および経度との間の距離を計算します。 重心が真の場合、距離は円の中心から指定の点までの距離として計算されます。 それ以外の場合は、円周上の最も近い点から指定された点までの距離が計算されます。 さらに、 重心
インフォボックスを非表示(): サークルのインフォボックスが表示されている場合は非表示にします。 それ以外の場合は何もしません
ロケーション設定(緯度、経度): 円の中心を指定の緯度と経度に移動します。 この方法は、緯度と経度を別々に設定するよりも効率的です
インフォボックスの表示(): 表示されていない場合は、円のインフォボックスを表示します。 それ以外の場合、このメソッドは効果がありません。 有効化インフォボックスプロパティが偽の場合でも、このメソッドを使用してインフォボックスを表示できます
フィーチャーコレクション
フィーチャーコレクションは、1つ以上のフィーチャーをグループ化したものです。 コレクション内のフィーチャーで発生したイベントは、コレクションコンポーネントの対応するイベントをトリガーします。 フィーチャーコレクションを外部リソースからロードして、マップにコンテンツを入力できます。 GeoJSONは現時点でサポートされている唯一のフォーマットです
プロパティ
フィーチャー: フィーチャーコレクションに存在するフィーチャーのリストがあれば、それを返します
フィーチャーFromGeoJSON: GeoJSONコンテンツを含む文字列からフィーチャーコレクションを作成します。 このような文字列のサイズを考えると、ソースプロパティを使用してアセットまたはWebからフィーチャーコレクションをロードすることをお勧めします
高さ: 高さ（ピクセル単位）
高さのパーセント: 高さをスクリーンの高さに対するパーセントで指定します
ソース: フィーチャーコレクションのコンテンツを生成するソースURL
目に見える: 画面に表示するかどうかを指定します。 表示されている場合は値は真、非表示になっている場合は偽です
横幅: 幅（ピクセル単位）
横幅の割合: 横幅を画面の横幅に対するパーセントで指定します
イベント
フィーチャーがクリックされたら(フィーチャー): フィーチャーがクリックされると、親フィーチャーコレクションも"フィーチャーがクリックされたら“イベントを受け取ります。 フィーチャーパラメータは、どの子フィーチャーがクリックされたかを示します
フィーチャーがドラッグされたら(フィーチャー): フィーチャーがドラッグされると、親フィーチャーコレクションも"フィーチャーがドラッグされたら"イベントを受け取ります。 フィーチャーパラメータはどの子フィーチャーがドラッグされたかを示します
フィーチャーが長押しクリックされたら(フィーチャー): フィーチャーが長押しクリックされると、親フィーチャーコレクションも"フィーチャーが長押しクリックされたら"イベントを受け取ります。 フィーチャーパラメータは、どの子フィーチャーが長押しクリックされたかを示します
フィーチャーがドラッグされ始めたら(フィーチャー): ユーザーがフィーチャーのドラッグを開始すると、親フィーチャーコレクションも"フィーチャーがドラッグされ始めたら"イベントを受け取ります。 フィーチャーパラメータはどの子フィーチャーがドラッグされたかを示します
フィーチャーのドラッグが終わったら(フィーチャー): ユーザーがフィーチャーのドラッグを停止すると、親フィーチャーコレクションは"フィーチャーのドラッグが終わったら"イベントも受け取ります。 フィーチャーパラメータはどの子フィーチャーがドラッグされたかを示します
フィーチャーを取得したら(url, フィーチャーズ): “フィーチャーを取得したら"イベントは、指定されたurlからフィーチャーコレクションが正常に読み取られたときに実行されます。 フィーチャーズパラメータは、 “説明からのフィーチャー作成"メソッドを使用してコンポーネントに変換できる機能の説明の一覧です
読み込みエラー(url, レスポンスコード, エラーメッセージ): “読み込みエラー"イベントは、指定されたurlでフィーチャーコレクション文書を処理中にエラーが発生したときに実行されます。 レスポンスコードパラメータはHTTPステータスコードを含み、 エラーメッセージパラメータは詳細なエラーメッセージを含みます
メソッド
説明からのフィーチャー作成(説明): フィーチャー説明を App Inventor マップフィーチャに変換します。Point はマーカーコンポーネントに、LineStrings はラインストリングコンポーネントに、Polygon（および MultiPolygon）はポリゴンコンポーネントに変換されます。フィーチャーにプロパティがある場合は、以下のマッピングを使用して App Inventor のプロパティにマッピングされます。不明
URLから取得(URL): 与えられたURLから GeoJSON フォーマットのフィーチャーコレクションをロードします。成功すると、"フィーチャーを取得したら"イベントが、与えられたURLと、(key, value) ペアのリストとして GeoJSON から解析されたフィーチャーのリストとともに発生します。失敗すると、"読み込みエラー"イベントが、該当する HTTP レスポンスコードとエラーメッセージとともに発生します