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

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

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

위치 조회 필드 구성요소 표시 유형

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

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

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

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

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

문자열이 제공되는 경우:

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

객체가 제공되는 경우:

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

데이터가 어떻게 보이는지에 대한 자세한 내용은 다음을 참조하세요. 장소 상세 정보

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

address_components.[component type]

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

장소 유형

필드 값 예:

{
    "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 (도로명 만 반환)