---
sourceDocument: 호주 판매 고객 관계 관리
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/order-management

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 판매 고객 관계 관리

ft:clusterId :

    - omgmt

bundleId :

    - omgmt

workflow :

    - Customer and Industry


---

# LocationLookup 필드

# LocationLookup 필드 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 3분

모든 텍스트 유형은 Google의 API를 사용하여 주소 데이터를 가져올 수 있는 LocationLookup 구성요소 표시 유형으로 정의할 수 있습니다.

LocationLookup 필드 구성요소 표시 유형은 Google의 Places API를 활용하여 고유한 위치 구성 및 가격 책정에 사용할 수 있는 주소 데이터를 가져옵니다. 모든 텍스트 필드 유형은 레이아웃 편집기를 사용하거나 레이아웃 CSV 파일을 직접 편집하여 LocationLookup 구성요소 표시 유형으로 정의할 수 있습니다.

실제로 보려면 다음 비디오를 시청하십시오.

[위치 조회 필드 구성요소 표시 유형](https://www.youtube.com/watch?v=Ofuq7Vza-wU)

LocationLookup 필드를 사용하려면 먼저 Google 장소에 액세스할 수 있는 권한이 있는 Google의 유효한 API 키가 있어야 합니다. API 키는 Maps JavaScript API와 장소 API 모두에 대해 구성되어 있어야 합니다.

필드 값에는 두 가지 속성이 keyfieldMapping필요합니다. 및 .

    {
      "key": API-Key-string,
      "fieldMapping": {"[field1VariableName]":"[returnedPlaceType]","[field2VariableName]":"[returnedPlaceType]"}
    }

key 속성은 API 키를 참조합니다.

fieldMapping 속성을 사용하여 반환된 장소 데이터를 구성의 다른 필드에 매핑하도록 UI에 지시합니다. 이 속성은 문자열 또는 키:값 쌍의 객체(둘 다 문자열)를 사용할 수 있습니다.

문자열이 제공되는 경우:

* 문자열은 구성에서 필드의 변수 이름이어야 합니다.
* API에서 반환된 데이터가 문자열로 변환되고 필드 값에 매핑됩니다.

{#the-location-lookup-field__ul_zwf_mtf_fhc}

객체가 제공되는 경우:

* 키는 구성 내 필드의 변수 이름이 됩니다.
* 값은 필드에 매핑되어야 하는 API의 데이터에 대한 JSON 경로입니다.

{#the-location-lookup-field__ul_lcb_4tf_fhc}

데이터가 어떻게 보이는지에 대한 자세한 내용은 다음을 참조하세요. [장소 상세 정보](https://developers.google.com/maps/documentation/places/web-service/details#Place)

주소 구성요소를 매핑하면 다양한 구성요소 값의 배열로 반환되므로 간단한 경로가 없습니다. UI에는 다음과 같은 형식이 필요합니다.

    address_components.[component type]

나열된 모든 유형이 장소 세부정보 API에서 반환되도록 보장되는 것은 아닙니다. 지원되는 유형을 찾으려면 다음 Google 웹사이트를 참고하세요.

[장소 유형](https://developers.google.com/maps/documentation/places/web-service/supported_types)

필드 값 예:

    {
        "key": "*********",
        "fieldMapping": {
            "formattedAddress": "formatted_address",
            "sublocality": "address_components.sublocality",
            "city": "address_components.locality",
            "stateForLocation": "address_components.administrative_area_level_1",
            "zipCode": "address_components.postal_code"
        }
    }

이 매핑은 세트에서도 작동합니다. 위치 필드와 매핑에 나열된 모든 필드 역시 세트의 일부여야 합니다. 교차 인덱스 또는 전역 필드는 세트에서 지원되지 않습니다.

Google Places API의 몇 가지 일반적인 매핑은 다음과 같습니다.

* formatted_address (사람이 읽을 수 있는 형식으로 전체 주소 반환)
* address_components.locality (도시 반환)
* address_components.administrative_area_level_1 (상태 반환)
* address_components.country
* address_components.postal_code
* address_components.street_number
* address_components.route (도로명 만 반환)
{#the-location-lookup-field__ul_kc1_ttf_fhc}