Google Maps API の設定

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：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 から正確な駆動時間の推定を取得するためにこのキーが必要です。
        • フォームの残りの値を入力します。
      2. テーブルのプロパティ定義を使用してマップを構成します。
      注:
      キーの取得、API の使用、および関連するサービス契約条件の詳細については、Google Web サイトの「入門ガイド」を参照してください。
      利用可能なライセンスなし
      1. Google から Google Maps JavaScript API キーを取得します。
      2. 関連エントリフォームで、 システムプロパティ > Google Map プロパティフォームで、[ google.maps.key ] フィールドに API キーを入力します。

        Now Platform® の位置情報管理では API キーが使用されます。Google Map でも位置情報管理およびマップビューの請求処理に使用されます。

      3. フォームの残りの値を入力します。
      4. テーブルのプロパティ定義を使用してマップを構成します。
      Google Maps API for Business と Google Maps JavaScript API Key の詳細については、「https://developers.google.com/maps/gmp-get-started」を参照してください。
    2. 設定を完了して保存したら、 マップページを作成するか、プラグインに含まれるデフォルトのページを使用します。
      マップページは、マップに表示されるデータとリンクの外観を定義します。レコードにリンクするすべてのマーカーを表示する方法のチュートリアルについては、ServiceNow コミュニティ の「Google Map にマップマーカーを表示する (Display Map Markers on Google Maps)」ブログの投稿を参照してください。
      プロパティ 説明
      google.maps.auto_close true の場合、新しいウィンドウを開く前に、マップ情報ウィンドウが自動的に閉じます。
      • タイプ：true/false
      • デフォルト値：true
      • 場所： システムプロパティ > Google Map
      google.maps.client Google Maps API for Business のクライアント ID。
      • タイプ：文字列
      • デフォルト値： gme-servicenow
      • 場所： システムプロパティ > Google Map
      google.maps.private.key Google Maps API for Business の秘密キー。このキーは、モバイルデバイスのデータを使用してシステム内のユーザーを正確に特定する位置情報管理機能を有効にします。
      • タイプ：文字列
      • デフォルト値：空
      • 場所： システムプロパティ > Google Map
      google.maps.version Google Maps API for Business の現在インストールされているバージョン番号。
      • タイプ：文字列
      • デフォルト値：現在のバージョン番号
      • 場所： システムプロパティ > Google Map
      google.maps.key サーバーの URL に関連付けられた Google Maps API for Business または Google Maps JavaScript API キー。このキーは、Google Maps API の開発使用を許可します。
      • タイプ：文字列
      • デフォルト値：空
      • 場所： システムプロパティ > Google Map
      google.maps.latitude マップの開始緯度。この値で Google Map に表示される開始位置を決定します。
      • タイプ：文字列
      • デフォルト値：36.008522
      • 場所： システムプロパティ > Google Map
      google.maps.longitude マップの開始経度。この値で Google Map のページに表示される開始位置を決定します。
      • タイプ：文字列
      • デフォルト値：-95.221764
      • 場所： システムプロパティ > Google Map
      google.maps.max_items マップに表示する最大項目数。
      • タイプ：整数
      • デフォルト値： 500
      • 場所： システムプロパティ > Google Map
      google.maps.table マップが使用するテーブル。テーブルには、名前、経度、緯度のフィールドが必要です。
      • タイプ：文字列
      • デフォルト値：cmn_location
      • 場所： システムプロパティ > Google Map
      google.maps.zoom マップの開始ズームレベル (最低は 1)
      • タイプ：文字列
      • デフォルト値： 4
      • 場所： システムプロパティ > Google Map
    3. 次の設定を実行します。
      1. 次のように移動する。 システムプロパティ > All (すべて).
      2. これらのシステムプロパティの値を設定します。
        システムプロパティ 説明
        google.maps.refresh.latlong.duration 場所の詳細が更新されるまでの日数。
        注:
        最大値は 30 です。
        google.maps.refresh.latlong.record_count_per_table スケジュール済みジョブを使用して 1 回の更新で処理できるテーブル内のレコードの最大数。
      3. 場所の詳細を格納するテーブルをマップ座標の更新構成 [cmn_co Agreement_refresh_config] テーブルに指定します。
      4. テーブルに座標が最後に取得されたときに追跡するフィールドがない場合：
        1. テーブルに [日付/時刻] タイプの [coordinates_retrieved_on] フィールドを作成します。
        2. 座標が最後に取得された時間を追跡するフィールドの値が、マップ座標の更新構成 [cmn_coordinate_refresh_config] テーブルに正しく入力されていることを確認します。修復スクリプトのサンプル [フィールドで更新された座標を更新 (Update coordinates updated on field)] を参照して、[coordinates_retrieved_on] フィールドの値を更新してください。
      5. 次のように移動する。 システム定義 > スケジュール済みジョブ.
      6. レコード [レコードの緯度経度情報を更新 (Refresh Latitude Longitude info of Records)] を開きます。
      7. [アクティブ] チェックボックスをオンにします。
      8. [実行] および [繰り返し間隔] で頻度の詳細を指定して、場所の詳細を更新する頻度を指定します。
        注:
        少なくとも 30 日に 1 回、場所の詳細を更新してください。
    4. オプション: 地域に基づいて ServiceNow インスタンスから Google Map にアクセスするには、次の構成を実行します。
      1. 次のように移動する。 ユーザー管理 (User Administration) > ユーザー.
      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. [保存] をクリックします。