---
sourceDocument: 요코하마 ServiceNow AI 플랫폼 관리
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/yokohama/platform-administration

 Release :

    - yokohama

ft:locale :

    - ko-KR

ft:publication_title :

    - 요코하마 ServiceNow AI 플랫폼 관리

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) 소요 시간: 7분

비즈니스용 Maps API 라이센스 또는 Google Maps JavaScript API 키의 Google 적절한 항목을 사용하여 지리적 위치 기능을 활성화합니다.

## 시작하기 전에

필요한 역할: admin

## 이 태스크 정보

기본 JavaScript를 사용하여 맵을 생성할 수 있으며 가장 복잡한 쿼리도 표시할 수 있을 만큼 유연합니다. 이러한 맵은 인스턴스의 기록에 대한 다양한 링크 유형을 포함하여 표준 Google 비즈니스용 Maps API 또는 Google Maps JavaScript API 키 매핑 기능을 사용합니다. 이 기능을 사용하려면 Maps 플러그인을 Google 설치해야 합니다.  
그림 1. 맵 페이지  
중요사항:  
2026년 5월부터 Google은 Google 지도에 대한 요청을 인증하기 위해 클라이언트 ID 사용을 중단합니다. 이 날짜부터 API 키가 유일하게 지원되는 인증 방법이 됩니다. 애플리케이션에서 client-id를 계속 사용하면(예: 를 google.maps.method property통해) Google 지도 요청이 실패합니다. 자세한 내용은 [클라이언트 ID 마이그레이션 가이드를](https://developers.google.com/maps/premium/migrate-client-id) 참조하십시오.

API 키를 사용해서만 인증하도록 구성을 업데이트합니다(<kbd class="ph userinput">즉, 키</kbd>로 설정google.maps.method). API 키 기반 인증에 대한 자세한 내용은 설명 google.maps.key 및 google.maps.key.geocoding 속성을 참조하십시오.

## 프로시저

1. Google 비즈니스 라이선스에 대한 Maps API는 더 이상 에서 사용할 수 Google없으므로 기존 라이선스가 있는지 여부에 따라 다음 절차 중 하나를 사용합니다.  
   주:  
   사용자는 생성된 키를 사용하지 Now Platform® 말고 자체 Google 지도 JavaScript API 키를 Google 사용해야 합니다.

   | 비즈니스 라이센스용 기존 Maps Google API를 사용할 수 있습니까? | 작업 |
   | 기존 라이센스 사용 가능 | 1. 다음에서 시스템 속성Google 지도 속성 양식: * google.maps.client 필드에 조직의 클라이언트 ID를 입력합니다. 이 ID는 `gme-mycompanyname`과 같이 `gme-`에서 시작 Google 하고 gme-로 시작합니다. * google.maps.client.key 필드에 비즈니스용 Maps API의 Google 비공개 키를 입력합니다. 인코딩된 키의 예는 `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 지도 클라이언트 ID 기반 구성은 더 이상 사용되지 않습니다. 클라이언트 ID 인증은 2026년 5월부터 지원되지 않으며 이에 의존하는 구성은 더 이상 작동하지 않습니다. |
   | 사용 가능한 라이선스 없음 | 1. 에서 Maps JavaScript API 키를 Google가져옵니다Google. 2. 다음에서 시스템 속성Google 지도 속성 양식에서 google.maps.key 필드에 API 키를 입력합니다. 의 Now Platform® 지리적 위치는 Maps에서 지리적 위치 및 맵 뷰 청구에도 사용하는 API 키를 Google 사용합니다. 3. 양식에 나머지 값을 입력합니다. 4. 테이블의 속성 정의를 사용하여 맵을 구성합니다. {#set-up-google-maps-api__ol_qnd_vpj_smb} |
   |-|-|

   {#set-up-google-maps-api__choicetable_okq_vnj_smb}  
   비즈니스용 Maps API 및 Google Maps JavaScript API 키에 대한 Google 자세한 내용은 문서를 참조하십시오<https://developers.google.com/maps/gmp-get-started>.
2. 구성을 완료하고 저장한 후 맵 페이지를 생성하거나 플러그인에 포함된 기본 페이지를 사용합니다.  
   맵 페이지는 맵에 표시되는 데이터와 링크의 모양을 정의합니다. 기록에 연결되는 모든 마커를 보는 방법에 대한 튜토리얼은 [Google 지도에 맵 마커 표시](https://community.servicenow.com/community?id=community_blog&sys_id=909ceae1dbd0dbc01dcaf3231f96192b) 블로그 게시물 ServiceNow 커뮤니티을 참조하십시오.  
   {#set-up-google-maps-api__table_edd_4zf_vt__entry__2}

   | 속성 | 설명 |
   |-|-|
   | google.maps.method | Google 지도에 사용할 인증 방법을 정의합니다. * 유형: 문자열 * 기본값: key * 위치: 시스템 속성Google 지도 {#set-up-google-maps-api__ul_td5_zx2_m3c} |
   | google.maps.auto_close | 예일 경우 새 창을 오픈 전에 맵 정보 창을 자동으로 닫습니다. * 유형: true/false * 기본값: true * 위치: 시스템 속성Google 지도 {#set-up-google-maps-api__ul_zb5_slr_bq} |
   | google.maps.client | 비즈니스용 Maps API의 Google 클라이언트 ID입니다. * 유형: 문자열 * 기본값: gme-servicenow * 위치: 시스템 속성Google 지도 {#set-up-google-maps-api__ul_pyj_ylr_bq} |
   | google.maps.client.key | 비즈니스용 Maps API의 Google 개인 키입니다. 이 키는 모바일 장치의 데이터를 사용하여 시스템에서 사용자를 정확하게 찾는 지리적 위치 기능을 활성화합니다. * 유형: 문자열 * 기본값: 비었음 * 위치: 시스템 속성Google 지도 {#set-up-google-maps-api__ul_j1k_zlr_bq} |
   | google.maps.version | 비즈니스용 Maps API의 Google 현재 설치의 버전 번호입니다. * 유형: 문자열 * 기본값: 현재 버전 번호 * 위치: 시스템 속성Google 지도 {#set-up-google-maps-api__ul_acs_zlr_bq} |
   | google.maps.key | Google 비즈니스용 API를 매핑하거나 Google 서버의 URL에 연결되는 JavaScript API 키를 매핑합니다. 이 키는 Maps API의 Google 개발 사용을 승인합니다. * 유형: 문자열 * 기본값: 비었음 * 위치: 시스템 속성Google 지도 {#set-up-google-maps-api__ul_zsx_zlr_bq} |
   | google.maps.key.geocoding | 비즈니스용 Google Maps API 또는 서버의 URL에 연결되는 Google Maps JavaScript API 키입니다. 이 키는 지오코딩 요청을 하는 데 사용됩니다. * 유형: 문자열 * 기본값: 비었음 * 위치: 시스템 속성Google 지도 {#set-up-google-maps-api__ul_drh_fy2_m3c} |
   | google.maps.latitude | 맵의 시작 위도입니다. 이 값은 맵에 표시되는 시작 위치를 결정합니다 Google . * 유형: 문자열 * 기본값: 36.008522 * 위치: 시스템 속성Google 지도 {#set-up-google-maps-api__ul_qvc_1mr_bq} |
   | google.maps.longitude | 맵의 시작 경도입니다. 이 값은 맵 페이지에 표시되는 Google 시작 위치를 결정합니다. * 유형: 문자열 * 기본값: -95.221764 * 위치: 시스템 속성Google 지도 {#set-up-google-maps-api__ul_pbp_1mr_bq} |
   | google.maps.max_항목 | 맵에 표시할 항목의 최대 수입니다. * 유형: 정수 * 기본값: 500 * 위치: 시스템 속성Google 지도 {#set-up-google-maps-api__ul_lgy_1mr_bq} |
   | google.maps.table | 맵에서 사용하는 테이블입니다. 테이블에는 이름, 경도, 위도 필드가 필요합니다. * 유형: 문자열 * 기본값: cmn_location * 위치: 시스템 속성Google 지도 {#set-up-google-maps-api__ul_xyd_bmr_bq} |
   | google.maps.zoom | 맵의 확대/축소 수준 시작(1이 가장 낮은 수준임) * 유형: 문자열 * 기본값: 4 * 위치: 시스템 속성Google 지도 {#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 | 예약된 작업을 사용하여 한 번의 새로 고침으로 처리할 수 있는 테이블의 최대 기록 수입니다. |
      [ ]

      {#set-up-google-maps-api__table_dww_kh2_r4b}
   3. 맵 좌표 새로 고침 구성\[cmn_coordinate_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. 기록을 열고 기록의 위도 경도 정보를 새로 고칩니다.
   7. 활성 확인란을 선택합니다.
   8. 실행 및 반복 간격으로 빈도 상세 정보를 제공하여 위치 상세 정보를 새로 고쳐야 하는 빈도를 지정합니다.  
      주:  
      30일마다 한 번 이상 위치 상세 정보를 새로 고쳐야 합니다.
   {#set-up-google-maps-api__substeps_fqt_gh2_r4b}
4. **옵션:** 지역에 따라 인스턴스에서 ServiceNow 맵에 액세스 Google 하려면 다음 구성을 수행합니다.
   1. 다음으로 이동 사용자 관리사용자.
   2. 필요한 사용자에 대한 관련 국가 코드를 선택하고 할당합니다.  
      주:  
      필요한 국가 코드를 사용할 수 없는 경우 딕셔너리 항목을 추가합니다. ISO 3166-1 국가 코드를 사용하는지 확인합니다. 예를 들어, 모로코의 국가 코드는 <kbd class="ph userinput">MA</kbd>입니다.
   3. 다음으로 이동 시스템 속성Google 지도.
   4. 지역에 따라 Google 지도의 동작을 변경하려는 경우에만 이 속성을 활성화하려면 예 확인란을 선택합니다. 이 지역은 sys_user 기록에서 현재 사용자의 "국가 코드" 필드 값으로 채워집니다. sys_user 기록의 국가 코드 값은 Google 지도 지역 코드의 예상값과 일치해야 합니다. 대부분의 유니코드 지역 식별자는 ISO 3166-1 코드와 동일하며 몇 가지 주목할만한 예외가 있습니다. 변경하기 전에 코드를 올바르게 확인하십시오.
   5. 저장을 클릭합니다.
   {#set-up-google-maps-api__substeps_xs5_vk5_kqb}