Google Maps API 설정

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 7분

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

    시작하기 전에

    필요한 역할: 관리자

    이 태스크 정보

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

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

    프로시저

    1. Google 비즈니스 라이선스에 대한 Maps API는 더 이상 에서 사용할 수 Google없으므로 기존 라이선스가 있는지 여부에 따라 다음 절차 중 하나를 사용합니다.
      주:
      사용자는 생성된 키를 사용하지 ServiceNow AI 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=입니다. ServiceNow AI Platform® 일부 지리적 위치 기능에서 정확한 예상 운전 시간을 Google 검색하려면 이 키가 필요합니다.
        • 양식에 나머지 값을 입력합니다.
      2. 테이블의 속성 정의를 사용하여 맵을 구성합니다.
      중요사항:

      Google 지도 클라이언트 ID 기반 구성은 더 이상 사용되지 않습니다. 클라이언트 ID 인증은 2026년 5월부터 지원되지 않으며 이에 의존하는 구성은 더 이상 작동하지 않습니다.
      사용 가능한 라이선스 없음
      1. 에서 Maps JavaScript API 키를 Google가져옵니다Google.
      2. 안에 시스템 속성 > Google 지도 속성 양식에서 google.maps.key 필드에 API 키를 입력합니다.

        의 ServiceNow AI Platform® 지리적 위치는 Maps에서 지리적 위치 및 맵 뷰 청구에도 사용하는 API 키를 Google 사용합니다.

      3. 양식에 나머지 값을 입력합니다.
      4. 테이블의 속성 정의를 사용하여 맵을 구성합니다.
      비즈니스용 Maps API 및 Google Maps JavaScript API 키에 대한 Google 자세한 내용은 문서를 참조하십시오https://developers.google.com/maps/gmp-get-started.
    2. 구성을 완료하고 저장한 후 맵 페이지를 생성하거나 플러그인에 포함된 기본 페이지를 사용합니다.
      맵 페이지는 맵에 표시되는 데이터와 링크의 모양을 정의합니다. 기록에 연결되는 모든 마커를 보는 방법에 대한 튜토리얼은 Google 지도에 맵 마커 표시 블로그 게시물 ServiceNow 커뮤니티을 참조하십시오.
      속성설명
      google.maps.methodGoogle 지도에 사용할 인증 방법을 정의합니다.
      • 유형: string
      • 기본값: key
      • 위치: 시스템 속성 > Google 지도
      google.maps.auto_close예일 경우 새 창을 오픈 전에 맵 정보 창을 자동으로 닫습니다.
      • 유형: true/false
      • 기본값: true
      • 위치: 시스템 속성 > Google 지도
      google.maps.client비즈니스용 Maps API의 Google 클라이언트 ID입니다.
      • 유형: string
      • 기본값: gme-servicenow
      • 위치: 시스템 속성 > Google 지도
      google.maps.map_id클라우드 기반 맵 스타일링, 벡터 맵 및 고급 마커에 사용되는 Google 지도의 맵 ID입니다. 맵 ID를 얻으려면 맵 ID를 만드는 방법을 참조하세요.
      • 유형: string
      • 기본값: 비었음
      • 위치: 시스템 속성 > Google 지도
      google.maps.client.key비즈니스용 Maps API의 Google 개인 키입니다. 이 키는 모바일 장치의 데이터를 사용하여 시스템에서 사용자를 정확하게 찾는 지리적 위치 기능을 활성화합니다.
      • 유형: string
      • 기본값: 비었음
      • 위치: 시스템 속성 > Google 지도
      google.maps.version비즈니스용 Maps API의 Google 현재 설치의 버전 번호입니다.
      • 유형: string
      • 기본값: 현재 버전 번호
      • 위치: 시스템 속성 > Google 지도
      google.maps.keyGoogle 비즈니스용 API를 매핑하거나 Google 서버의 URL에 연결되는 JavaScript API 키를 매핑합니다. 이 키는 Maps API의 Google 개발 사용을 승인합니다.
      • 유형: string
      • 기본값: 비었음
      • 위치: 시스템 속성 > Google 지도
      google.maps.key.geocoding비즈니스용 Google Maps API 또는 서버의 URL에 연결되는 Google Maps JavaScript API 키입니다. 이 키는 지오코딩 요청을 하는 데 사용됩니다.
      • 유형: 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] 테이블에 올바르게 채워져 있는지 확인합니다. 샘플 수정 스크립트 Update coordinates updated on field 를 참조하여 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. 저장을 클릭합니다.