PowerApps の Acceleration、App、Compass、Connection、Location の各シグナルAcceleration, App, Compass, Connection, and Location signals in PowerApps

ユーザーが地球上のどこにいて、どの画面が表示されているかなど、アプリの環境に関する情報を取得することができます。Returns information about the app's environment, such as where the user is located in the world and which screen is displayed.

説明と構文Description and syntax

すべてのシグナルは、情報のレコードを返します。All signals return a record of information. この情報は、レコードとして使用や保存ができるほか、.You can use and store this information as a record, or you can extract individual properties by using the . 演算子.operator.

AccelerationAcceleration

Acceleration シグナルは、デバイスの画面に対して相対的な 3 次元におけるデバイスの加速度を返します。The Acceleration signal returns the device's acceleration in three dimensions relative to the device's screen. 加速度は、9.81 m/秒2 単位または 32.2 ft/秒2 単位、つまり g (地球の重力によって地上の物体に与えられる加速度) で表されます。Acceleration is measured in g units of 9.81 m/second2 or 32.2 ft/second2 (the acceleration that the Earth imparts to objects at its surface due to gravity).

シグナルのプロパティSignal Property 説明Description
Acceleration.XAcceleration.X 左右。Right and left. 正数は右を表します。Right is a positive number.
Acceleration.YAcceleration.Y 前後。Forward and back. 正数は前を表します。Forward is a positive number.
Acceleration.ZAcceleration.Z 上下。Up and down. 正数は上を表します。Up is a positive number.

AppApp

App シグナルは、実行中のアプリに関する情報を返します。The App signal returns information about the running app.

シグナルのプロパティSignal Property 説明Description
App.ActiveScreenApp.ActiveScreen 表示されている画面。Screen that's displayed. スクリーン オブジェクトを返します。このオブジェクトを使って画面のプロパティを参照したり、別の画面と比較してどちらの画面が表示されているかを調べたりすることができます。Returns a screen object, which you can use to reference properties of the screen or compare to another screen to determine which screen is displayed. Back 関数または Navigate 関数を使うことで、表示画面を変更することができます。By using the Back or Navigate function, you can change the displayed screen.

CompassCompass

Compass シグナルは、画面上部のコンパスの方位を返します。The Compass signal returns the compass heading of the top of the screen. 方位は磁北に基づきます。The heading is based on magnetic north.

シグナルのプロパティSignal Property 説明Description
Compass.HeadingCompass.Heading 方位 (度)。Heading in degrees. 0 を北として、0 ~ 360 の数値を返します。Returns a number 0 to 360, and 0 is north.

接続Connection

Connection シグナルは、ネットワーク接続に関する情報を返します。The Connection signal returns the information about the network connection. 従量制課金接続では、そのネットワーク上で送受信するデータ量を制限したい場合があります。When on a metered connection, you may want to limit how much data you send or receive over the network.

シグナルのプロパティSignal Property 説明Description
Connection.ConnectedConnection.Connected デバイスがネットワークに接続されているかどうかを示すブール値 true または false を返します。Returns a Boolean true or false value that indicates whether the device is connected to a network.
Connection.MeteredConnection.Metered 従量制課金接続であるかどうかを示すブール値 true または false を返します。Returns a Boolean true or false value that indicates whether the connection is metered.

場所Location

Location 信号は、GPS (Global Positioning System) やその他のデバイス情報 (携帯電話の基地局通信、IP アドレスなど) に基づくデバイスの位置を返します。The Location signal returns the location of the device based on the Global Positioning System (GPS) and other device information, such as cell-tower communications and IP address.

ユーザーは、位置情報に初めてアクセスするとき、その情報へのアクセスを許可するようデバイスから求められる場合があります。When a user accesses the location information for the first time, the device may prompt that user to allow access to this information.

位置との従属関係は、位置が変化する過程で絶えず再計算され、デバイスのバッテリが消費されます。As the location changes, dependencies on the location will continuously recalculate, which will consume power from the device's battery. バッテリの駆動時間を節約するために、Enable 関数と Disable 関数を使って位置情報の更新のオンとオフを切り替えることができます。To conserve battery life, you can use the Enable and Disable functions to turn location updates on and off. 表示されている画面が位置情報に依存していない場合は、位置情報が自動的にオフになります。Location is automatically turned off if the displayed screen doesn't depend on location information.

シグナルのプロパティSignal Property 説明Description
Location.AltitudeLocation.Altitude 海抜で測った高度 (フィート) を示す数値を返します。Returns a number that indicates the altitude, measured in feet, above sea level.
Location.LatitudeLocation.Latitude 赤道との角度で表される緯度を示す -90 ~ 90 の数値を返します。Returns a number, from -90 to 90, that indicates the latitude, as measured in degrees from the equator. 正数は、赤道より北の位置を示します。A positive number indicates a location that's north of the equator.
Location.LongitudeLocation.Longitude イギリスのグリニッジから西に向かって測定された経度を示す 0 ~ 180 の数値を返します。Returns a number, from 0 to 180, that indicates the longitude, as measured in degrees west from Greenwich, England.

Examples

ワシントン州シアトルのセーフコ・フィールド球場にあるピッチャー マウンドからホーム ベースのキャッチャーにスマートフォンを投げるとします。From the pitcher's mound at Safeco Field in Seattle, Washington, a baseball pitcher throws a phone to a catcher at home plate. スマートフォンは、地面に対して平らに置かれており、画面の上部は、キャッチャーの方を向いています。また、ピッチャーは回転を一切加えません。The phone is lying flat with respect to the ground, the top of the screen is pointed at the catcher, and the pitcher adds no spin. この位置でスマートフォンは、従量制課金の移動体通信ネットワーク サービスを利用できますが、WiFi は利用できません。At this location, the phone has cellular network service that's metered but no WiFi. PlayBall 画面は表示されています。The PlayBall screen is displayed.

数式Formula 説明Description 結果Result
Location.LatitudeLocation.Latitude 現在位置の緯度を返します。Returns the latitude of the current location. 地図上におけるセーフコ・フィールド球場の座標は 47.591 N, 122.333 W です。Safeco Field is located at map coordinates 47.591 N, 122.333 W. 47.59147.591

ピッチャーからキャッチャーまでボールが移動する間、緯度は絶えず変化します。The latitude will change continuously as the ball moves between the pitcher and the catcher.
Location.LongitudeLocation.Longitude 現在位置の経度を返します。Returns the longitude of the current location. 122.333122.333

ピッチャーからキャッチャーまでボールが移動する間、経度は絶えず変化します。The longitude will change continuously as the ball moves between the pitcher and the catcher.
LocationLocation 現在位置の緯度と経度をレコードとして返します。Returns the latitude and longitude of the current location, as a record. { Latitude: 47.591, Longitude: 122.333 }{ Latitude: 47.591, Longitude: 122.333 }
Compass.HeadingCompass.Heading 画面上部のコンパスの方位を返します。Returns the compass heading of the top of the screen. セーフコ・フィールド球場のホーム ベースは、ピッチャー マウンドのおよそ南西に位置しています。At Safeco Field, home plate is roughly southwest from the pitcher's mound. 230.25230.25
Acceleration.XAcceleration.X デバイスの左右の加速度を返します。Returns the acceleration of the device side to side. ピッチャーは、スマートフォンを画面の上部に対してまっすぐに投げるので、デバイスの左右方向の加速度はゼロです。The pitcher is throwing the phone straight ahead with respect to the screen's top, so the device isn't accelerating side to side. 00
Acceleration.YAcceleration.Y デバイスの前後の加速度を返します。Returns the acceleration of the device front to back. ピッチャーはデバイスを投げる際、最初に大きな加速度を与えます。時速 0 マイルの状態から 0.5 秒後には時速 90 マイル (毎秒 132 フィート) に達します。The pitcher initially gives the device a large acceleration when throwing the device, going from 0 to 90 miles per hour (132 feet per second) in half a second. デバイスが空中に放たれた後は、デバイスがそれ以上加速することはありません (空気摩擦は無視します)。After the device is in the air, ignoring air friction, the device doesn't accelerate further. デバイスは減速し、キャッチャーが受けた時点で停止します。The device decelerates when the catcher catches it, bringing it to a stop. ピッチャーがデバイスを投げている間は 8.2 となります。8.2, while the pitcher throws the device.

デバイスが空中にある間は 0 になります。0, while the device is in the air.

キャッチャーがデバイスを受けたときは、-8.2 になります。-8.2, as the catcher catches the device.
Acceleration.ZAcceleration.Z デバイスの上下の加速度を返します。Returns the acceleration of the device top to bottom. 空中を飛んでいるデバイスは重力の影響を受けます。While in the air, the device experiences the effects of gravity. ピッチャーがデバイスを投げる前は 0 です。0, before the pitcher throws the device.

デバイスが空中にある間は 1 になります。1, while the device is in the air.

キャッチャーがデバイスを受けた後は 0 になります。0, after the catcher catches the device.
AccelerationAcceleration 加速度をレコードとして返します。Returns the acceleration as a record. ピッチャーがデバイスを投げるときは { X: 0, Y: 264, Z: 0 } になります。{ X: 0, Y: 264, Z: 0 } as the pitcher throws the device.
Connection.ConnectedConnection.Connected デバイスがネットワークに接続されているかどうかを示すブール値を返します。Returns a Boolean value that indicates whether the device is connected to a network truetrue
Connection.MeteredConnection.Metered 従量制課金接続であるかどうかを示すブール値を返します。Returns a Boolean value that indicates whether the connection is metered truetrue
App.ActiveScreen = PlayBallApp.ActiveScreen = PlayBall PlayBall が表示されているかどうかを示すブール値を返します。Returns a Boolean value that indicates whether PlayBall is displayed. truetrue
App.ActiveScreen.FillApp.ActiveScreen.Fill 表示画面の背景色を返します。Returns the background color for the displayed screen. Color.GreenColor.Green