GlideGeoPoint - グローバル

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：8分

    • GlideGeoPoint API を使用すると、テーブル内のジオポイントデータタイプ値を取得および設定できます。

    この API はデフォルトで利用可能です。ジオポイント データ タイプを使用すると、緯度と経度の値をテーブル内の 1 つのフィールドに格納できます。GlideGeoPoint API を使用すると、新しい GlideGeoPoint オブジェクトをインスタンス化したり、特定のテーブルに新しいジオポイントを作成したり、単一の緯度、経度、またはジオタイプ値を取得したりすることができます。ジオポイントを使用した新しいレコードの挿入、ジオポイント位置間の距離の計算、近くのジオポイント位置のクエリなど、特定のユースケースを実装する方法の詳細については、「 GlideGeoPoint 開発者ガイド」を参照してください。

    ジオタイプ データ タイプの主な側面は次のとおりです。
    • これは、経度と緯度の値を表す 10 進数のペアで構成されます。
    • 経度の範囲は (-180, 180) です。この範囲外の値は、この範囲内の同等の値に正規化されます。
    • 緯度の範囲は [-90, 90] です。この範囲外の値は、この範囲内の同等の値に正規化されます。
    • ジオポイント値は常に入力として受け入れられ、"longitude,latitude" のようにカンマで区切られたペアとして表示されます。オプションで式を括弧で囲むことができます。
    • 経度と緯度の両方の値は、小数点以下 6 桁までの精度で格納されます。
    注:
    GlideGeoPoint API 値は常に経度、緯度の順にリストされます。

    このページの例では、カスタム テーブルにジオポイント フィールド タイプを含むフィールドが事前に入力されていることを前提としています。このデータ型の詳細については、「 Geo point field type と Function field」を参照してください。

    GlideGeoPoint - GlideGeoPoint()

    GlideGeoPoint オブジェクトをインスタンス化します。GlideGeoPoint オブジェクトは、文字列として格納される経度と緯度の値にセマンティック認識を追加します。

    表 : 1. パラメーター
    名前 タイプ 説明
    なし

    次の例は、新しい GlideGeoPoint オブジェクトを null 値として初期化する方法を示しています。

    var gp = new GlideGeoPoint();

    GlideGeoPoint - GlideGeoPoint(文字列 longitude, 文字列 latitude)

    指定された経度と緯度の値に従って GlideGeoPoint オブジェクトをインスタンス化します。

    表 : 2. パラメーター
    名前 タイプ 説明
    経度 文字列 ジオポイントの経度座標。
    緯度 文字列 ジオポイントの緯度座標。
    表 : 3. 返される内容
    タイプ 説明
    ジオポイント 結果の GlideGeoPoint オブジェクト。

    次の例は、経度と緯度の値を指定して、それに応じてオブジェクトを初期化する方法を示しています。

    // Providing longitude and latitude values initializes the object accordingly 
var gp = new GlideGeoPoint(10.123, 25.987);  
gs.info("geopoint: " + gp);

    出力:

    geopoint: 10.123000,25.987000

    GlideGeoPoint - GlideGeoPoint(オブジェクト geoPoint)

    経度と緯度のポイントの値をコピーして、新しい GlideGeoPoint オブジェクトをインスタンス化します。

    表 : 4. パラメーター
    名前 タイプ 説明
    ジオポイント オブジェクト コピーするジオポイントインスタンス。
    表 : 5. 返される内容
    タイプ 説明
    ジオポイント 結果の GlideGeoPoint オブジェクト。

    次の例は、経度と緯度の値をコピーして、新しい GlideGeoPoint オブジェクトをインスタンス化する方法を示しています。

    var gp = new GlideGeoPoint(135, -64);
var gpCopy = new GlideGeoPoint(gp); 
gs.info("geopoint: " + gpCopy);
    出力:
    geopoint: 135,-64

    GlideGeoPoint - getDisplayValue()

    現在のユーザーのジオポイントを分かりやすい形式で返します。

    getDisplayValue() メソッドは、単一のジオポイント値を返します。特定のテーブルからすべてのジオポイント値を取得する方法については、「 GlideGeoPoint 開発者ガイド」をご参照ください。

    表 : 6. パラメーター
    名前 タイプ 説明
    なし
    表 : 7. 返される内容
    タイプ 説明
    文字列 オブジェクトに設定された経度と緯度の座標の値。 
    var gp = new GlideGeoPoint(); 
gp.setValue(76.25, 49.75);      
gs.info("geopoint: " + gp); 
gs.info("getDisplayValue(): " + gp.getDisplayValue());

    出力:

    geopoint: 76.250000,49.750000 
getDisplayValue(): (76.250000, 49.750000)

    GlideGeoPoint - getGeoPoint(文字列 geo_point_field_name)

    位置情報ポイントタイプの指定されたフィールド名の位置情報ポイント座標値のリストを返します。

    表 : 8. パラメーター
    名前 タイプ 説明
    geo_point_field_name 文字列 位置情報フィールドの名前。辞書エントリ [sys_dictionary] テーブルにあります。
    注:
    また、テーブルで定義された辞書要素の下にあるフィールド名を検索して、ジオポイントタイプの関連フィールドを表示することもできます。
    表 : 9. 返される内容
    タイプ 説明
    オブジェクト 結果の GlideGeoPoint オブジェクト。

    次の例では、「test_table」はジオポイントタイプの「geo_point」フィールドを含むテーブルです。test_tableには、geo_point列に (-30.560000,-54.330000) の値が設定されたレコードが 1 つあります。このコード例は、geo_point列のレコードの緯度と経度の座標と表示値を返します。

    var gr_Test = new GlideRecord('test_table');
gr_Test.query();
gr_Test.next();
var gp = gr_Test.getGeoPoint('geo_point');
gs.info("getLatitude(): " + gp.getLatitude());
gs.info("getLongitude(): " + gp.getLongitude());
gs.info("getDisplayValue(): " + gp.getDisplayValue());

    出力:

    getLatitude(): -54.33
getLongitude(): -30.560000000000002 
getDisplayValue(): (-30.560000, -54.330000)

    GlideGeoPoint - getLatitude()

    GlideGeoPoint オブジェクトの緯度値を返します。

    表 : 10. パラメーター
    名前 タイプ 説明
    なし
    表 : 11. 返される内容
    タイプ 説明
    文字列 GlideGeoPoint オブジェクトの緯度値。 
    var gp = new GlideGeoPoint(); 
gp.setValue(76.25, 49.75);      

gs.info("geopoint: " + gp); 
gs.info("getLatitude(): " + gp.getLatitude());

    出力:

    geopoint: 76.250000,49.750000 
getLatitude(): 49.75

    GlideGeoPoint - getLongitude()

    GlideGeoPoint オブジェクトの経度値を返します。

    表 : 12. パラメーター
    名前 タイプ 説明
    なし
    表 : 13. 返される内容
    タイプ 説明
    文字列 GlideGeoPoint オブジェクトの経度値。 
    var gp = new GlideGeoPoint(); 
gp.setValue(76.25, 49.75);      
gs.info("geopoint: " + gp);  
gs.info("getLongitude(): " + gp.getLongitude());

    出力:

    geopoint: 76.250000,49.750000 
 getLongitude(): 76.25

    GlideGeoPoint - getValue()

    現在の GlideGeoPoint オブジェクトのプログラムによる経度と緯度の値を含む文字列を返します。

    表 : 14. パラメーター
    名前 タイプ 説明
    なし
    表 : 15. 返される内容
    タイプ 説明
    文字列 現在の GlideGeoPoint オブジェクトの経度と緯度の値。 
     var gp = new GlideGeoPoint(); 
gp.setValue(76.25, 49.75);      
gs.info("geopoint: " + gp);
gs.info("getValue(): " + gp.getValue());

    出力:

    geopoint: 76.250000,49.750000
getValue(): 76.250000,49.750000

    GlideGeoPoint - setValue(文字列 経度, 文字列 緯度)

    ジオポイントの経度と緯度の値を設定します。

    表 : 16. パラメーター
    名前 タイプ 説明
    経度 文字列 ジオポイントの経度座標。
    緯度 文字列 ジオポイントの緯度座標。
    表 : 17. 返される内容
    タイプ 説明
    文字列 GlideGeoPoint オブジェクトに設定された経度と緯度の値。 
    var gp = new GlideGeoPoint(); 
gp.setValue("-28.48,38.91");      
gs.info("geopoint: " + gp);

    出力:

    geopoint: -28.480000,38.910000

    GlideGeoPoint - setValue(文字列値)

    ジオポイントの経度と緯度の値をカンマで区切った 1 つの値で設定します。

    表 : 18. パラメーター
    名前 タイプ 説明
    value 文字列 経度と緯度のポイントをそれぞれ含むカンマ区切りの値。
    表 : 19. 返される内容
    タイプ 説明
    文字列 GlideGeoPoint オブジェクトに設定された経度と緯度の値。

    次の例は、1 つの文字列を使用して経度と緯度の値を設定する方法を示しています。

    var gp = new GlideGeoPoint();
gp.setValue(23.4, 56.7);

    出力:

    geopoint: -23.400000,56.700000