Google Maps API 설정

Maps API for Business 라이선스 또는 Maps JavaScript API 키의 GoogleGoogle 적절한 항목을 사용하여 위치정보 기능을 사용 설정합니다.

시작하기 전에

필요한 역할: admin

이 태스크 정보

기본 JavaScript를 사용하여 맵을 생성할 수 있으며 가장 복잡한 쿼리도 표시할 수 있을 만큼 유연합니다. 이러한 지도는 인스턴스의 기록에 대한 다양한 링크 유형을 포함하여 표준 Google Maps API for Business 또는 Google Maps JavaScript API 키 매핑 기능을 사용합니다. 이 기능을 사용하려면 맵 플러그인을 Google 설치해야 합니다.

그림 1. 맵 페이지

프로시저

1. Google Maps API for Business 라이선스는 에서 더 이상 사용할 수 Google없으므로 기존 라이선스가 있는지 여부에 따라 다음 절차 중 하나를 사용합니다.
   주:

   생성된 키를 사용하지 Now Platform® 않고 자체 Google Maps JavaScript API 키를 Google 사용해야 합니다.

   기존 Google Maps API for Business 라이선스를 사용할 수 있나요?	작업
   기존 라이센스 사용 가능	안에 시스템 속성 > Google 지도 재산 형태 : google.maps.client 입력란에 조직의 클라이언트 ID를 입력합니다. 이 ID는 Googlegme-mycompanyname과 같이 gme-에서 시작하며 gme-로 시작합니다. google.maps.private.key 입력란에 Maps API for Business의 Google 비공개 키를 입력합니다. 인코딩된 키의 예는 vNIXE0xscrmjlyV-12Nj_BvUPaw=입니다. Now Platform® 일부 지리적 위치 기능에 대한 정확한 예상 운전 시간을 Google 검색하려면 이 키가 필요합니다. 양식의 나머지 값을 입력합니다. 테이블의 속성 정의를 사용하여 맵을 구성합니다. 주: 키 가져오기, API 사용 및 관련 서비스 약관에 대한 자세한 내용은 웹 사이트의 시작 안내서Google 를 참조하세요.
   사용 가능한 라이센스 없음	에서 GoogleMaps JavaScript API 키를 가져옵니다Google. 안에 시스템 속성 > Google 지도 속성 양식에서 google.maps.key 필드에 API 키를 입력합니다. 의 Now Platform® 지리적 위치는 API 키를 사용하며, Google 지도는 지리적 위치 및 지도 보기 청구에도 이 키를 사용합니다. 양식의 나머지 값을 입력합니다. 테이블의 속성 정의를 사용하여 맵을 구성합니다.

   Maps API for Business 및 Google Maps JavaScript API 키에 대한 Google 자세한 내용은 을 참고https://developers.google.com/maps/gmp-get-started하세요.
2. 구성을 완료하고 저장한 후 맵 페이지를 만들거나 플러그인에 포함된 기본 페이지를 사용합니다.
   맵 페이지는 맵에 나타나는 데이터와 링크의 모양을 정의합니다. 레코드에 연결되는 모든 마커를 보는 방법에 대한 튜토리얼은 Google 지도에 맵 마커 표시 블로그 게시물을 ServiceNow 커뮤니티참조하십시오.

   속성	설명
   google.maps.auto_close	예일 경우 새 창을 열기 전에 맵 정보 창을 자동으로 닫습니다. 유형: true/false 기본값: true 위치: 시스템 속성 > Google 지도
   google.maps.client	비즈니스용 Maps API의 Google 클라이언트 ID입니다. 유형: 문자열 기본값: gme-servicenow 위치: 시스템 속성 > Google 지도
   google.maps.private.key	비즈니스용 Maps API의 Google 비공개 키입니다. 이 키는 모바일 장치의 데이터를 사용하여 시스템에서 사용자를 정확하게 찾는 지리적 위치 기능을 활성화합니다. 유형: 문자열 기본값: 비었음 위치: 시스템 속성 > Google 지도
   google.maps.version	현재 설치된 Google Maps API for Business의 버전 번호입니다. 유형: 문자열 기본값: 현재 버전 번호 위치: 시스템 속성 > Google 지도
   google.maps.key	Google 서버의 URL에 연결되는 Maps API for Business 또는 Google Maps JavaScript API 키입니다. 이 키는 Maps API의 Google 개발 사용을 승인합니다. 유형: 문자열 기본값: 비었음 위치: 시스템 속성 > Google 지도
   google.maps.latitude	맵의 시작 위도입니다. 이 값은 맵에 Google 표시되는 시작 위치를 결정합니다. 유형: 문자열 기본값: 36.008522 위치: 시스템 속성 > Google 지도
   google.maps.경도	맵의 시작 경도입니다. 이 값은 지도 페이지에 표시되는 Google 시작 위치를 결정합니다. 유형: 문자열 기본값: -95.221764 위치: 시스템 속성 > Google 지도
   google.maps.max_items	맵에 표시할 최대 항목 수입니다. 유형: 정수 기본값: 500 위치: 시스템 속성 > Google 지도
   google.maps.table	맵에서 사용하는 테이블. 테이블에는 다음 필드가 필요합니다: 이름, 경도, 위도. 유형: 문자열 기본값: cmn_location 위치: 시스템 속성 > Google 지도
   google.maps.zoom	맵의 확대/축소 수준 시작(1이 가장 낮은 수준임) 유형: 문자열 기본값: 4 위치: 시스템 속성 > Google 지도

3. 다음 구성을 수행합니다.
   1. 다음으로 이동 시스템 속성 > 모두레이블이 표시됩니다.
   2. 다음 시스템 속성의 값을 설정합니다.

      시스템 속성	설명
      google.maps.refresh.latlong.duration	위치 상세 정보가 업데이트되는 기간(일 수)입니다. 주: 최대값은 30입니다.
      google.maps.refresh.latlong.record_count_per_table	한 번의 새로 고침에서 예약된 작업을 사용하여 처리할 수 있는 테이블의 최대 기록 수입니다.

   3. 지도 좌표 새로 고침 구성 [cmn_coordinate_refresh_config] 테이블에 위치 상세 정보를 저장하는 테이블을 지정합니다.
   4. 테이블에서 좌표가 마지막으로 검색될 때 추적할 필드가 없는 경우:
      1. 테이블에 날짜/시간 유형의 coordinates_retrieved_on 필드를 생성합니다.
      2. 좌표가 마지막으로 검색될 때 시간을 추적하는 필드의 값이 맵 좌표 새로 고침 구성 [cmn_coordinate_refresh_config] 테이블에 올바르게 채워져 있는지 확인합니다. 샘플 수정 스크립트 필드에서 업데이트된 좌표 를 참조하여 coordinates_retrieved_on 필드의 값을 업데이트합니다.
   5. 다음으로 이동 시스템 정의 > 예약된 작업레이블이 표시됩니다.
   6. 레코드를 열고 레코드의 위도 경도 정보를 새로 고칩니다.
   7. 활성 확인란을 선택합니다.
   8. 실행 및 반복 간격에 빈도 상세 정보를 제공하여 위치 상세 정보를 새로 고쳐야 하는 빈도를 지정합니다.
      주:

      30일마다 한 번 이상 위치 상세 정보를 새로 고쳐야 합니다.
4. 옵션: 지역을 기반으로 인스턴스에서 ServiceNow 맵에 액세스 Google 하려면 다음 구성을 수행하십시오.
   1. 다음으로 이동 사용자 관리 > 사용자레이블이 표시됩니다.
   2. 필요한 사용자에 대한 관련 국가 코드를 선택하고 할당합니다.
      주:

      필요한 국가 코드를 사용할 수 없는 경우 사전 항목을 추가합니다. ISO 3166-1 국가 코드를 사용해야 합니다. 예를 들어 모로코의 국가 코드는 MA입니다.
   3. 다음으로 이동 시스템 속성 > Google 지도레이블이 표시됩니다.
   4. 활성화. 다음 옵션에 대해 예 확인란을 선택합니다:지역에 따라 Google 지도의 동작을 변경하려는 경우에만 이 속성 활성화에 대해 지역은 sys_user 기록에서 현재 사용자의 "국가 코드" 필드 값으로 채워집니다. sys_user 기록의 국가 코드 값은 Google 지도 지역 코드의 예상값과 일치해야 합니다. 대부분의 유니코드 지역 식별자는 ISO 3166-1 코드와 동일하지만 몇 가지 주목할 만한 예외가 있습니다. 변경하기 전에 코드를 올바르게 확인하십시오.
   5. 저장을 클릭합니다.

관련 태스크

• 맵 페이지 생성
• 맵 페이지 모듈 생성
• 고급 맵 페이지 생성
• 맵 애플리케이션 범위 설정
• 스마트폰 맵 페이지 모듈 생성

관련 참조

• 맵 페이지에 대한 스크립팅