---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideGeoPoint - グローバル

# GlideGeoPoint - グローバル {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：8分

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

この API はデフォルトで利用可能です。ジオポイント データ タイプを使用すると、緯度と経度の値をテーブル内の 1 つのフィールドに格納できます。GlideGeoPoint API を使用すると、新しい GlideGeoPoint オブジェクトをインスタンス化したり、特定のテーブルに新しいジオポイントを作成したり、単一の緯度、経度、またはジオタイプ値を取得したりすることができます。ジオポイントを使用した新しいレコードの挿入、ジオポイント位置間の距離の計算、近くのジオポイント位置のクエリなど、特定のユースケースを実装する方法の詳細については、「 [GlideGeoPoint 開発者ガイド](https://servicenow-prod.fluidtopics.net/V5aUKnuYNpm5hPQsPPYGAA#geopoint-dev-guide "GlideGeoPoint 開発者ガイドには、緯度と経度の値 (ジオポイント) 間の距離を計算する方法、指定されたジオポイントと半径の値内の位置を返す方法、サポートされている GlideGeoPoint API 関数によって提供される追加機能を使用する方法に関する情報が含まれています。")」を参照してください。  
ジオタイプ データ タイプの主な側面は次のとおりです。

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

このページの例では、カスタム テーブルにジオポイント フィールド タイプを含むフィールドが事前に入力されていることを前提としています。このデータ型の詳細については、「 [Geo point field type](https://www.servicenow.com/docs/access?context=geo-point-field-type&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US) と [Function field](https://www.servicenow.com/docs/access?context=platform-support-functions&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。

## GlideGeoPoint - GlideGeoPoint() {#ariaid-title2}

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

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

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

    var gp = new GlideGeoPoint();

## GlideGeoPoint - GlideGeoPoint(文字列 longitude, 文字列 latitude) {#ariaid-title3}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| 経度 | 文字列 | ジオポイントの経度座標。 |
| 緯度 | 文字列 | ジオポイントの緯度座標。 |
[表 : 2. パラメーター]

{#GlideGeoPoint-GlideGeoPoint_S_S__table_jf5_zvc_wxb} {#GlideGeoPoint-GlideGeoPoint_S_S__table_kf5_zvc_wxb__entry__2}

| タイプ | 説明 |
|-|-|
| ジオポイント | 結果の GlideGeoPoint オブジェクト。 |
[表 : 3. 返される内容]

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

    // 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) {#ariaid-title4}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| ジオポイント | オブジェクト | コピーするジオポイントインスタンス。 |
[表 : 4. パラメーター]

{#GlideGeoPoint-GlideGeoPoint_O__table_egf_cxc_wxb} {#GlideGeoPoint-GlideGeoPoint_O__table_fgf_cxc_wxb__entry__2}

| タイプ | 説明 |
|-|-|
| ジオポイント | 結果の GlideGeoPoint オブジェクト。 |
[表 : 5. 返される内容]

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

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

出力:

    geopoint: 135,-64

## GlideGeoPoint - getDisplayValue() {#ariaid-title5}

現在のユーザーのジオポイントを分かりやすい形式で返します。
getDisplayValue() メソッドは、単一のジオポイント値を返します。特定のテーブルからすべてのジオポイント値を取得する方法については、「 [GlideGeoPoint 開発者ガイド](https://servicenow-prod.fluidtopics.net/V5aUKnuYNpm5hPQsPPYGAA#geopoint-dev-guide "GlideGeoPoint 開発者ガイドには、緯度と経度の値 (ジオポイント) 間の距離を計算する方法、指定されたジオポイントと半径の値内の位置を返す方法、サポートされている GlideGeoPoint API 関数によって提供される追加機能を使用する方法に関する情報が含まれています。")」をご参照ください。
{#GlideGeoPoint-getDisplayValue__table_rr1_24t_qxb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 6. パラメーター]

{#GlideGeoPoint-getDisplayValue__table_rr1_24t_qxb} {#GlideGeoPoint-getDisplayValue__table_sr1_24t_qxb__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | オブジェクトに設定された経度と緯度の座標の値。 |
[表 : 7. 返される内容]

{#GlideGeoPoint-getDisplayValue__table_sr1_24t_qxb}  

    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) {#ariaid-title6}

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

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

{#GlideGeoPoint-getGeoPoint_S__table_bz4_jsl_5bc} {#GlideGeoPoint-getGeoPoint_S__table_cz4_jsl_5bc__entry__2}

| タイプ | 説明 |
|-|-|
| オブジェクト | 結果の GlideGeoPoint オブジェクト。 |
[表 : 9. 返される内容]

{#GlideGeoPoint-getGeoPoint_S__table_cz4_jsl_5bc}  
次の例では、「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() {#ariaid-title7}

GlideGeoPoint オブジェクトの緯度値を返します。
{#GlideGeoPoint-getLatitude__table_w24_fpt_qxb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 10. パラメーター]

{#GlideGeoPoint-getLatitude__table_w24_fpt_qxb} {#GlideGeoPoint-getLatitude__table_x24_fpt_qxb__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | GlideGeoPoint オブジェクトの緯度値。 |
[表 : 11. 返される内容]

{#GlideGeoPoint-getLatitude__table_x24_fpt_qxb}  

    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() {#ariaid-title8}

GlideGeoPoint オブジェクトの経度値を返します。
{#GlideGeoPoint-getLongitude__table_fmz_t4t_qxb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 12. パラメーター]

{#GlideGeoPoint-getLongitude__table_fmz_t4t_qxb} {#GlideGeoPoint-getLongitude__table_gmz_t4t_qxb__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | GlideGeoPoint オブジェクトの経度値。 |
[表 : 13. 返される内容]

{#GlideGeoPoint-getLongitude__table_gmz_t4t_qxb}  

    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() {#ariaid-title9}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 14. パラメーター]

{#GlideGeoPoint-getValue__table_cvs_2zg_4xb} {#GlideGeoPoint-getValue__table_dvs_2zg_4xb__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | 現在の GlideGeoPoint オブジェクトの経度と緯度の値。 |
[表 : 15. 返される内容]

{#GlideGeoPoint-getValue__table_dvs_2zg_4xb}  

     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(文字列 経度, 文字列 緯度) {#ariaid-title10}

ジオポイントの経度と緯度の値を設定します。
{#GlideGeoPoint-setValue_S_S__table_gw3_4qg_4xb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| 経度 | 文字列 | ジオポイントの経度座標。 |
| 緯度 | 文字列 | ジオポイントの緯度座標。 |
[表 : 16. パラメーター]

{#GlideGeoPoint-setValue_S_S__table_gw3_4qg_4xb} {#GlideGeoPoint-setValue_S_S__table_hw3_4qg_4xb__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | GlideGeoPoint オブジェクトに設定された経度と緯度の値。 |
[表 : 17. 返される内容]

{#GlideGeoPoint-setValue_S_S__table_hw3_4qg_4xb}  

    var gp = new GlideGeoPoint(); 
    gp.setValue("-28.48,38.91");      
    gs.info("geopoint: " + gp);

出力:

    geopoint: -28.480000,38.910000

## GlideGeoPoint - setValue(文字列値) {#ariaid-title11}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| value | 文字列 | 経度と緯度のポイントをそれぞれ含むカンマ区切りの値。 |
[表 : 18. パラメーター]

{#GlideGeoPoint-setValue_S__table_mng_gyc_wxb} {#GlideGeoPoint-setValue_S__table_nng_gyc_wxb__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | GlideGeoPoint オブジェクトに設定された経度と緯度の値。 |
[表 : 19. 返される内容]

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

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

出力:

    geopoint: -23.400000,56.700000