GlideGeoPoint - グローバル

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：8分

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

    この API はデフォルトで利用可能です。ジオポイントデータタイプを使用すると、テーブル内の単一のフィールドに緯度と経度の値を格納できます。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(文字列経度、文字列緯度)

    指定された経度と緯度の値に従って 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(文字列値)

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

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

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

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

    出力:

    geopoint: -23.400000,56.700000