latlon2JapanMeshCodeコマンド マニュアル

(The documentation of latlon2JapanMeshCode command)
Last Update: 2022/3/5

◆機能・用途(Purpose)

緯度経度を与えて緯度経度を与えて対応する日本の地域メッシュコードを求める。
Calculate the regional mesh code of Japan for a given latitude and longitude.

◆ソースコード(Source code)

$YMAEDA_OPENTOOL_DIR/geography/src/latlon2JapanMeshCode.c


◆使用方法(Usage)

コマンドライン引数でパラメータを指定する。 パラメータの一覧を下表に示す。
Specify parameters by command-line arguments. The table below shows a list of parameters.

●「-」から始まらない引数 (Arguments not beginning with “-”)

引数
Argument 		与える値
Quantity to be given
第1引数
1st argument 		緯度(度単位または度:分:秒表記)。
Latitude (in degrees or degree:minute:second format).
第2引数
2nd argument 		経度(度単位または度:分:秒表記)。
Longitude (in degrees or degree:minute:second format).


●1つの「-」から始まる引数 (Arguments beginning with a single “-”)

このコマンドでは1つの「-」から始まる引数は存在しない。
This command does not have arguments beginning with a single “-”.

●「--パラメータ名=パラメータ値」の形式の引数 (Arguments of a form “--Parameter name=Parameter Value”)

「--パラメータ名=パラメータ値」の形式の引数は自由な順番で指定できる。 「-」から始まらない引数の間に挿入しても良い。 相反する指定がなされた場合には後の指定が優先される。 デフォルト値を持つパラメータは省略できる。
Arguments of a form “--Parameter name=Parameter Value” can be placed in an arbitrary order. They can even be inserted between arguments not beginning with “-”. In case of conflicting options being specified, the latter option has a higher priority. Parameters that have default values can be omitted.
パラメータ名
Parameter name 		意味
Meaning 		可能なパラメータ値
Allowed parameter values 		デフォルト値
Default value
meshLevel 出力するメッシュコードのレベル。
Level of the mesh code to output.
  • 1
    1次メッシュコード(4桁)を出力する。
    Output the 1st mesh code (4-digits).

  • 2
    2次メッシュコード(6桁)を出力する。
    Output the 2nd mesh code (6-digits).

  • 3
    3次メッシュコード(8桁)を出力する。
    Output the 3rd mesh code (8-digits).

 3
shift_quantity_N 指定した緯度に加算する量。 地図をプロットする場合や地形を考慮に入れた解析を行う場合など、 ある1地点のメッシュコードではなく 対象領域内に含まれるメッシュコードのリストが必要になる場合がある。 そのようなときに 「指定した座標を含むメッシュの1つ北に隣接するメッシュコード」や 「指定した座標の0.1度南のメッシュコード」 などが簡単に計算できると便利なのでこのオプションを用意した。
The quantity to be added to the latitude specified. When plotting a map or performing an analysis taking into account the topography, the mesh code at a single location is not enough; rather, a list of mesh codes that are included in the target region. In these cases, calculations of, for example, “the code of the mesh that is by 1 mesh north to the mesh that includes the specified location” or “the code of the mesh that includes the location that is by 0.1 degrees south of the specified location” are needed. This option was introduced for convenience of getting these mesh codes easily. 		実数値。但し移動量をメッシュ数で指定する場合は整数値。 移動量の単位は--shift_unitオプションで指定する。 正の値を指定すれば北に、負の値を指定すれば南に座標を移動させる。
A real number; however, this value must be an integer if the unit of this quantity is the number of meshes. The unit of this quantity is specified by option --shift_unit. Positive and negative values mean movements to north and south, respectively. 		0.0
shift_quantity_E 指定した経度に加算する量。 考え方は--shift_quantity_Nオプションと同様。
The quantity to be added to the longitude specified; see --shift_quantity_N option for detail. 		実数値。但し移動量をメッシュ数で指定する場合は整数値。 移動量の単位は--shift_unitオプションで指定する。 正の値を指定すれば東に、負の値を指定すれば西に座標を移動させる。
A real number; however, this value must be an integer if the unit of this quantity is the number of meshes. The unit of this quantity is specified by option --shift_unit. Positive and negative values mean movements to east and west, respectively. 		0.0
shift_unit --shift_quantity_N, --shift_quantity_E オプションで指定した値の単位。
The unit of the quantities given by options --shift_quantity_N and --shift_quantity_E.
  • mesh
    メッシュ数。 メッシュコードのレベルは--meshLevelオプションに合わせる。
    The number of meshes; the mesh code level is determined based on --meshLevel option.

  • mesh1
    1次メッシュコードのメッシュ数。
    The number of meshes in the 1st mesh code.

  • mesh2
    2次メッシュコードのメッシュ数。
    The number of meshes in the 2nd mesh code.

  • mesh3
    3次メッシュコードのメッシュ数。
    The number of meshes in the 3rd mesh code.

  • deg
    緯度または経度(度)。
    The latitude or longitude in degrees.

  • min
    緯度または経度(分)。
    The latitude or longitude in minutes.

  • sec
    緯度または経度(秒)。
    The latitude or longitude in seconds.

 mesh


◆動作(Behaviour)

計算したメッシュコードが標準出力に表示される。
The calculated mesh code is displayed in the standard output.

◆使用例(Example)

latlon2JapanMeshCode 35.1546 136.9668 \
    --meshLevel=2 --shift_quantity_N=1 --shift_quantity_E=-1

この例では35.1546N, 136.9668Eから北と西に1メッシュずつずらした地点の 2次メッシュコードが出力される。
In this example, the 2nd mesh code at the location that is by 1 mesh north and west from 35.1546N, 136.9668E is displayed.

◆追加の情報(Additional information)

日本の地域メッシュコードについては 関数JapanMeshCode2latlonRange (coordinate.h)のマニュアル参照。
For the regional mesh code of japan, see the documentation of function JapanMeshCode2latlonRange (coordinate.h).