Google Maps API 설정

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 6분

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

    시작하기 전에

    필요한 역할: 관리자

    이 태스크 정보

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

    프로시저

    1. Google 비즈니스 라이선스용 Maps API는 에서 Google더 이상 사용할 수 없으므로 기존 라이선스가 있는지 여부에 따라 다음 절차 중 하나를 사용합니다.
      주:
      생성된 키를 사용하지 ServiceNow AI Platform® 않고 자체 Google 지도 JavaScript API 키를 Google 사용해야 합니다.
      기존 Google Maps API for Business 라이센스를 사용할 수 있습니까?작업
      기존 라이센스 사용 가능
      1. 안에 시스템 속성 > Google 지도 속성 양식:
        • google.maps.client 입력란에 조직의 클라이언트 ID를 입력합니다. 이 ID는 gme-mycompanyname과 같이 gme-에서 시작하고 Google 시작합니다.
        • google.maps.private.key 입력란에 Maps API for Business의 Google 비공개 키를 입력합니다. 인코딩된 키의 예는 vNIXE0xscrmjlyV-12Nj_BvUPaw=입니다. 일부 ServiceNow AI Platform® 지리적 위치 기능에 대한 정확한 운전 시간 추정치 Google 를 검색하려면 이 키가 필요합니다.
        • 양식의 나머지 값을 입력합니다.
      2. 테이블의 속성 정의를 사용하여 맵을 구성합니다.
      주:
      키 획득, API 사용 및 관련 서비스 약관에 대한 자세한 내용은 웹 사이트의 시작 가이드를Google 참조하십시오.
      사용 가능한 라이센스 없음
      1. 에서 GoogleMaps JavaScript API 키를 가져옵니다Google.
      2. 안에 시스템 속성 > Google 지도 속성 양식에서 API 키를 google.maps.key 필드에 입력합니다.

        의 ServiceNow AI Platform® 지리적 위치는 지도가 지리적 위치 및 지도 보기 청구에도 사용하는 API 키를 Google 사용합니다.

      3. 양식의 나머지 값을 입력합니다.
      4. 테이블의 속성 정의를 사용하여 맵을 구성합니다.
      비즈니스용 Maps API 및 Google Maps JavaScript API 키에 대한 Google 자세한 내용은 를 참조하세요https://developers.google.com/maps/gmp-get-started.
    2. 구성을 완료하고 저장한 후 맵 페이지를 생성하거나 플러그인에 포함된 기본 페이지를 사용합니다.
      맵 페이지는 맵에 표시되는 데이터와 링크의 모양을 정의합니다. 레코드로 연결되는 모든 마커를 보는 방법에 대한 튜토리얼은 의 Google 지도에 지도 마커 표시 블로그 게시물을 ServiceNow 커뮤니티참조하세요.
      속성 설명
      google.maps.auto_close true일 경우 새 창을 열기 전에 맵 정보 창을 자동으로 닫습니다.
      • 유형: true/false
      • 기본값: true
      • 위치: 시스템 속성 > Google 지도
      google.maps.client 비즈니스용 Maps API의 Google 클라이언트 ID입니다.
      • 유형: string
      • 기본값: gme-servicenow
      • 위치: 시스템 속성 > Google 지도
      google.maps.private.key 비즈니스용 Maps API의 Google 개인 키입니다. 이 키는 모바일 장치의 데이터를 사용하여 시스템에서 사용자를 정확하게 찾는 지리적 위치 기능을 활성화합니다.
      • 유형: string
      • 기본값: 비었음
      • 위치: 시스템 속성 > Google 지도
      google.maps.version 비즈니스용 Maps API의 Google 현재 설치 버전 번호입니다.
      • 유형: string
      • 기본값: 현재 버전 번호
      • 위치: 시스템 속성 > Google 지도
      google.maps.key Google 비즈니스용 Maps API 또는 Google Maps JavaScript API 서버의 URL에 연결된 키입니다. 이 키는 Maps API의 Google 개발 사용을 승인합니다.
      • 유형: string
      • 기본값: 비었음
      • 위치: 시스템 속성 > Google 지도
      google.maps.latitude 맵의 시작 위도입니다. 이 값은 맵에 Google 표시되는 시작 위치를 결정합니다.
      • 유형: string
      • 기본값: 36.008522
      • 위치: 시스템 속성 > Google 지도
      google.maps.longitude 맵의 시작 경도입니다. 이 값은 맵 페이지에 표시되는 Google 시작 위치를 결정합니다.
      • 유형: string
      • 기본값: -95.221764
      • 위치: 시스템 속성 > Google 지도
      google.maps.max_항목 맵에 표시할 최대 항목 수입니다.
      • 유형: 정수
      • 기본값: 500
      • 위치: 시스템 속성 > Google 지도
      google.maps.table 맵에서 사용하는 테이블. 테이블에는 이름, 경도, 위도 필드가 필요합니다.
      • 유형: string
      • 기본값: cmn_location
      • 위치: 시스템 속성 > Google 지도
      google.maps.zoom 맵의 확대/축소 수준 시작(1이 가장 낮은 수준입니다.)
      • 유형: string
      • 기본값: 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. 저장을 클릭합니다.