--- sourceDocument: Yokohama ServiceNow AI Platform 管理 sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/yokohama/platform-administration Release : - yokohama ft:locale : - ja-JP ft:publication_title : - Yokohama ServiceNow AI Platform 管理 ft:clusterId : - platadm bundleId : - platadm workflow : - Platform --- # Google Maps API の設定 # Google Maps API の設定 {#ariaid-title1} * リリースバージョン: Yokohama * * 更新日 2025年01月30日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：9分 Google Maps API for Business ライセンスまたは Google Maps JavaScript API Key の適切なエントリを使用して、位置情報管理機能を有効にします。 ## 始める前に必要なロール：アドミン ## このタスクについて基本的な JavaScript を使用してマップを生成できます。また、非常に複雑なクエリでも表示できる柔軟性を備えています。これらのマップでは、インスタンス内のレコードへのさまざまなリンクタイプを含む、標準の Google Maps API for Business または Google Maps JavaScript API Key マッピング機能を使用します。この機能を使用するには、Google Maps プラグインをインストールする必要があります。図 : 1. マップページ重要: 2026 年 5 月以降、Google は Google マップへのリクエストを認証するためのクライアント ID の使用を廃止します。この日付以降、API キーのみがサポートされる認証方法になります。アプリケーションで引き続き client-id を使用する場合 (たとえば、 google.maps.method property経由)、Google Maps のリクエストは失敗します。詳細については、「 [クライアント ID 移行ガイド](https://developers.google.com/maps/premium/migrate-client-id)」を参照してください。 API キーのみを使用して認証するように構成を更新します (つまり、google.maps.methodキーに設定します)。API キーベースの認証の詳細については、 google.maps.key プロパティと google.maps.key.geocoding プロパティの説明を参照してください。 ## 手順 1. Google Maps APIs for Business のライセンスは Google から利用できなくなりました。そのため、既存のライセンスがあるかどうかに応じて、次のいずれかの手順を使用します。注: Google から取得した独自の Google Maps JavaScript API キーを使用する必要があり、Now Platform® で生成されたキーは使用しません。 | 既存の Google Maps API for Business ライセンス利用可否 | タスク | | 既存のライセンス利用可 | 1. のシステムプロパティGoogle Map プロパティフォーム: * \[google.maps.client\] フィールドに、組織のクライアント ID を入力します。この ID は Google から提供されるもので、`gme-mycompanyname` などのように `gme-` で始まります。 * \[google.maps.client.key\] フィールドに、Google Maps API for Business の秘密鍵を入力します。エンコードキーは、たとえば `vNIXE0xscrmjlyV-12Nj_BvUPaw=` といったものです。Now Platform® には、一部の位置情報管理機能について Google から正確な駆動時間の推定を取得するためにこのキーが必要です。 * フォームの残りの値を入力します。 {#set-up-google-maps-api__ul_wxf_1sj_smb} 2. テーブルのプロパティ定義を使用してマップを構成します。 {#set-up-google-maps-api__ol_hqp_wnj_smb} 重要: Google Maps クライアント ID ベースの構成は廃止されます。クライアント ID 認証は 2026 年 5 月以降サポートされなくなり、これに依存する構成は機能しなくなります。 | | 利用可能なライセンスなし | 1. Google から Google Maps JavaScript API キーを取得します。 2. のシステムプロパティGoogle Map プロパティフォームで、\[ google.maps.key \] フィールドに API キーを入力します。 Now Platform® の位置情報管理では API キーが使用されます。Google Map でも位置情報管理およびマップビューの請求処理に使用されます。 3. フォームの残りの値を入力します。 4. テーブルのプロパティ定義を使用してマップを構成します。 {#set-up-google-maps-api__ol_qnd_vpj_smb} | |-|-| {#set-up-google-maps-api__choicetable_okq_vnj_smb} Google Maps API for Business と Google Maps JavaScript API Key の詳細については、「」を参照してください。 2. 設定を完了して保存したら、マップページを作成するか、プラグインに含まれるデフォルトのページを使用します。マップページは、マップに表示されるデータとリンクの外観を定義します。レコードにリンクするすべてのマーカーを表示する方法のチュートリアルについては、ServiceNow コミュニティの「[Google Map にマップマーカーを表示する (Display Map Markers on Google Maps)](https://community.servicenow.com/community?id=community_blog&sys_id=909ceae1dbd0dbc01dcaf3231f96192b)」ブログの投稿を参照してください。 {#set-up-google-maps-api__table_edd_4zf_vt__entry__2} | 財産 | 説明 | |-|-| | google.maps.method | Google マップに使用する認証手法を定義します。 * タイプ：文字列 * デフォルト値:キー * 場所：システムプロパティGoogle Map {#set-up-google-maps-api__ul_td5_zx2_m3c} | | google.maps.auto_close | true の場合、新しいウィンドウを開く前に、マップ情報ウィンドウが自動的に閉じます。 * タイプ：true/false * デフォルト値：true * 場所：システムプロパティGoogle Map {#set-up-google-maps-api__ul_zb5_slr_bq} | | google.maps.client | Google Maps API for Business のクライアント ID。 * タイプ：文字列 * デフォルト値： gme-servicenow * 場所：システムプロパティGoogle Map {#set-up-google-maps-api__ul_pyj_ylr_bq} | | google.maps.client.key | Google Maps API for Business の秘密キー。このキーは、モバイルデバイスのデータを使用してシステム内のユーザーを正確に特定する位置情報管理機能を有効にします。 * タイプ：文字列 * デフォルト値：空 * 場所：システムプロパティGoogle Map {#set-up-google-maps-api__ul_j1k_zlr_bq} | | google.maps.version | Google Maps API for Business の現在インストールされているバージョン番号。 * タイプ：文字列 * デフォルト値：現在のバージョン番号 * 場所：システムプロパティGoogle Map {#set-up-google-maps-api__ul_acs_zlr_bq} | | google.maps.key | サーバーの URL に関連付けられた Google Maps API for Business または Google Maps JavaScript API キー。このキーは、Google Maps API の開発使用を許可します。 * タイプ：文字列 * デフォルト値：空 * 場所：システムプロパティGoogle Map {#set-up-google-maps-api__ul_zsx_zlr_bq} | | google.maps.key.geocoding | サーバーの URL と関連付ける Google Maps API for business または Google Maps JavaScript API キー。このキーは、ジオコーディング要求を行うために使用されます。 * タイプ：文字列 * デフォルト値：空 * 場所：システムプロパティGoogle Map {#set-up-google-maps-api__ul_drh_fy2_m3c} | | google.maps.latitude | マップの開始緯度。この値で Google Map に表示される開始位置を決定します。 * タイプ：文字列 * デフォルト値：36.008522 * 場所：システムプロパティGoogle Map {#set-up-google-maps-api__ul_qvc_1mr_bq} | | google.maps.longitude | マップの開始経度。この値で Google Map のページに表示される開始位置を決定します。 * タイプ：文字列 * デフォルト値：-95.221764 * 場所：システムプロパティGoogle Map {#set-up-google-maps-api__ul_pbp_1mr_bq} | | google.maps.max_items | マップに表示する最大項目数。 * タイプ：整数 * デフォルト値： 500 * 場所：システムプロパティGoogle Map {#set-up-google-maps-api__ul_lgy_1mr_bq} | | google.maps.table | マップが使用するテーブル。テーブルには、名前、経度、緯度のフィールドが必要です。 * タイプ：文字列 * デフォルト値：cmn_location * 場所：システムプロパティGoogle Map {#set-up-google-maps-api__ul_xyd_bmr_bq} | | google.maps.zoom | マップの開始ズームレベル (最低は 1) * タイプ：文字列 * デフォルト値： 4 * 場所：システムプロパティGoogle Map {#set-up-google-maps-api__ul_tys_bmr_bq} | [ ] {#set-up-google-maps-api__table_edd_4zf_vt} 3. 次の設定を実行します。 1. 移動先システムプロパティすべて. 2. これらのシステムプロパティの値を設定します。 {#set-up-google-maps-api__table_dww_kh2_r4b__entry__2} | システムプロパティ | 説明 | |-|-| | google.maps.refresh.latlong.duration | 場所の詳細が更新されるまでの日数。注: 最大値は 30 です。 | | google.maps.refresh.latlong.record_count_per_table | スケジュール済みジョブを使用して 1 回の更新で処理できるテーブル内のレコードの最大数。 | [ ] {#set-up-google-maps-api__table_dww_kh2_r4b} 3. 場所の詳細を格納するテーブルをマップ座標の更新構成 \[cmn_co Agreement_refresh_config\] テーブルに指定します。 4. テーブルに座標が最後に取得されたときに追跡するフィールドがない場合： 1. テーブルに \[日付/時刻\] タイプの \[coordinates_retrieved_on\] フィールドを作成します。 2. 座標が最後に取得された時間を追跡するフィールドの値が、マップ座標の更新構成 \[cmn_coordinate_refresh_config\] テーブルに正しく入力されていることを確認します。修復スクリプトのサンプル \[フィールドで更新された座標を更新 (Update coordinates updated on field)\] を参照して、\[coordinates_retrieved_on\] フィールドの値を更新してください。 {#set-up-google-maps-api__ol_rt4_m32_r4b} 5. 移動先システム定義スケジュール済みジョブ. 6. レコード \[レコードの緯度経度情報を更新 (Refresh Latitude Longitude info of Records)\] を開きます。 7. \[アクティブ\] チェックボックスをオンにします。 8. \[実行\] および \[繰り返し間隔\] で頻度の詳細を指定して、場所の詳細を更新する頻度を指定します。注: 少なくとも 30 日に 1 回、場所の詳細を更新してください。 {#set-up-google-maps-api__substeps_fqt_gh2_r4b} 4. **オプション:** 地域に基づいて ServiceNow インスタンスから Google Map にアクセスするには、次の構成を実行します。 1. 移動先ユーザー管理ユーザー. 2. 必要なユーザーに関連する \[国コード\] を選択して割り当てます。注: 必要な \[国コード\] が利用できない場合は、辞書エントリを追加します。ISO 3166-1 国コードを使用していることを確認してください。たとえば、モロッコの国コードが「MA」であるとします。 3. 移動先システムプロパティGoogle Map. 4. 次の場合、\[はい\] チェックボックスをオンにします。\[地域に基づいて Google Map の動作を変更する場合にのみ、このプロパティを有効にします。地域は、sys_user レコードの現在のユーザーの \[国コード\] フィールド値から入力されます。sys_user レコードの国コード値は、Google Map の地域コードから推測される値と一致している必要があります。ほとんどの Unicode 地域識別子は ISO 3166-1 コードと同じですが、いくつかの例外があります。変更を加える前にコードを適切に確認してください。(Enable this property only when you want to alter the Google map's behavior based on a region. The region is populated from the current User's 'Country code' field value in sys_user record. The Country code value on the sys_user record should be consistent with the expectations from the Google Map's region code. Most Unicode region identifiers are identical to ISO 3166-1 codes, with some notable exceptions. Check the codes properly before making any changes.)\] 5. \[保存\] をクリックします。 {#set-up-google-maps-api__substeps_xs5_vk5_kqb}