---
sourceDocument: オーストラリア API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference

 Release :

    - australia

ft:locale :

    - ja-JP

ft:publication_title :

    - オーストラリア API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideGeoPoint - グローバル

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

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

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

この API はデフォルトで利用可能です。ジオポイントデータタイプを使用すると、テーブル内の単一のフィールドに緯度と経度の値を格納できます。GlideGeoPoint API を使用すると、新しい GlideGeoPoint オブジェクトのインスタンスを作成したり、特定のテーブルの新しいジオポイントを作成したり、単一の緯度、経度、またはジオタイプの値を取得したりできます。ジオポイントを使用した新しいレコードの挿入、ジオポイント位置間の距離の計算、近くのジオポイント位置のクエリなど、特定のユースケースを実装する方法の詳細については、「 [GlideGeoPoint 開発者ガイド](https://servicenow-prod.fluidtopics.net/ukjgbQLCd0AsZ7AfDH2p2Q#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=australia&pubname=australia-platform-administration&ft:locale=en-US) と [Function field](https://www.servicenow.com/docs/access?context=platform-support-functions&version=australia&pubname=australia-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(文字列経度、文字列緯度) {#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/ukjgbQLCd0AsZ7AfDH2p2Q#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}

カンマで区切られた単一の値を使用して、ジオポイントの経度と緯度の値を設定します。
{#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}  
次の例は、単一の文字列を使用して経度と緯度の値を設定する方法を示しています。

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

出力:

    geopoint: -23.400000,56.700000