GlideGeoPoint - グローバル

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：8分

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

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

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

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

    GlideGeoPoint - GlideGeoPoint()

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

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

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

    var gp = new GlideGeoPoint();

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

    指定された経度と緯度の値に従って 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(String longitude, String latitude)

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

    表 : 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 オブジェクトに設定された経度と緯度の値。

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

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

    出力:

    geopoint: -23.400000,56.700000