--- sourceDocument: Xanadu Now Platform の管理 sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/platform-administration Release : - xanadu ft:locale : - ja-JP ft:publication_title : - Xanadu Now Platform の管理 ft:clusterId : - platadm bundleId : - platadm workflow : - Platform --- # Google Maps API の設定 # Google Maps API の設定 {#ariaid-title1} * リリースバージョン: Xanadu * * 更新日 2024年08月01日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：8分 Google Maps API for Business ライセンスまたは Google Maps JavaScript API Key の適切なエントリを使用して、位置情報管理機能を有効にします。 ## 始める前に 必要なロール：admin ## このタスクについて 基本的な JavaScript を使用してマップを生成できます。また、非常に複雑なクエリでも表示できる柔軟性を備えています。これらのマップでは、インスタンス内のレコードへのさまざまなリンクタイプを含む、標準の Google Maps API for Business または Google Maps JavaScript API Key マッピング機能を使用します。この機能を使用するには、Google Maps プラグインをインストールする必要があります。 図 : 1. マップページ ## 手順 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.private.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} 注: キーの取得、API の使用、および関連するサービス契約条件の詳細については、Google Web サイトの「[入門ガイド](https://developers.google.com/maps/documentation/javascript/tutorial)」を参照してください。 | | 利用可能なライセンスなし | 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 Community の「[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.auto_close | true の場合、新しいウィンドウを開く前に、マップ情報ウィンドウが自動的に閉じます。 * タイプ：true/false * デフォルト値：true * \[Location (場所)\]： システムプロパティGoogle Map {#set-up-google-maps-api__ul_zb5_slr_bq} | | google.maps.client | Google Maps API for Business のクライアント ID。 * タイプ：文字列 * デフォルト値： gme-servicenow * \[Location (場所)\]： システムプロパティGoogle Map {#set-up-google-maps-api__ul_pyj_ylr_bq} | | google.maps.private.key | Google Maps API for Business の秘密キー。このキーは、モバイルデバイスのデータを使用してシステム内のユーザーを正確に特定する位置情報管理機能を有効にします。 * タイプ：文字列 * デフォルト値：空 * \[Location (場所)\]： システムプロパティGoogle Map {#set-up-google-maps-api__ul_j1k_zlr_bq} | | google.maps.version | Google Maps API for Business の現在インストールされているバージョン番号。 * タイプ：文字列 * デフォルト値：現在のバージョン番号 * \[Location (場所)\]： システムプロパティ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 の開発使用を許可します。 * タイプ：文字列 * デフォルト値：空 * \[Location (場所)\]： システムプロパティGoogle Map {#set-up-google-maps-api__ul_zsx_zlr_bq} | | google.maps.latitude | マップの開始緯度。この値で Google Map に表示される開始位置を決定します。 * タイプ：文字列 * デフォルト値：36.008522 * \[Location (場所)\]： システムプロパティGoogle Map {#set-up-google-maps-api__ul_qvc_1mr_bq} | | google.maps.longitude | マップの開始経度。この値で Google Map のページに表示される開始位置を決定します。 * タイプ：文字列 * デフォルト値：-95.221764 * \[Location (場所)\]： システムプロパティGoogle Map {#set-up-google-maps-api__ul_pbp_1mr_bq} | | google.maps.max_items | マップに表示する最大項目数。 * タイプ：整数 * デフォルト値： 500 * \[Location (場所)\]： システムプロパティGoogle Map {#set-up-google-maps-api__ul_lgy_1mr_bq} | | google.maps.table | マップが使用するテーブル。テーブルには、名前、経度、緯度のフィールドが必要です。 * タイプ：文字列 * デフォルト値：cmn_location * \[Location (場所)\]： システムプロパティGoogle Map {#set-up-google-maps-api__ul_xyd_bmr_bq} | | google.maps.zoom | マップの開始ズームレベル (最低は 1) * タイプ：文字列 * デフォルト値： 4 * \[Location (場所)\]： システムプロパティ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}