GlideGeoPoint - グローバル

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む7読むのに数分

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

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

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

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

    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 - getLatitude()

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

    表 : 8. パラメーター
    名前 タイプ 説明
    なし
    表 : 9. 返される内容
    タイプ 説明
    文字列 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 オブジェクトの経度値を返します。

    表 : 10. パラメーター
    名前 タイプ 説明
    なし
    表 : 11. 返される内容
    タイプ 説明
    文字列 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 オブジェクトのプログラムによる経度と緯度の値を含む文字列を返します。

    表 : 12. パラメーター
    名前 タイプ 説明
    なし
    表 : 13. 返される内容
    タイプ 説明
    文字列 現在の 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(文字列 longitude, 文字列 latitude)

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

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

    出力:

    geopoint: -28.480000,38.910000

    GlideGeoPoint - setValue(文字列 value)

    ジオポイントの経度と緯度の値をカンマで区切った単一の値を使用して設定します。

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

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

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

    出力:

    geopoint: -23.400000,56.700000