다음을 통해 공유


주소 입력 컨트롤을 사용하여 주소를 쉽게 입력

특히 모바일 앱에서 주소를 입력하면 답답하고 오류가 발생하기 쉽습니다. 주소 입력 컨트롤을 사용하면 주소를 더 쉽게 입력할 수 있습니다. 컨트롤은 퍼지 논리를 사용하여 입력할 때 잠재적인 일치 항목을 제안합니다. 원하는 주소를 선택하여 정확한 주소를 쉽고 빠르게 입력하세요.

컨트롤은 주소를 구조화된 데이터로 반환합니다. 앱은 도시, 거리, 시정 당국, 심지어 위도 및 경도 좌표와 같은 정보를 추출할 수 있습니다. 데이터는 많은 로캘 및 국제 주소 형식에 적합한 형식입니다.

전제 조건

앱에서 컨트롤을 사용하려면 먼저 환경에 대해 지리 공간적 기능을 활성화해야 합니다. 또한 지리 공간적 제어 사용을 위한 전제 조건을 검토하십시오. 주소 입력 컨트롤의 데이터 사용에 대한 자세한 내용은 개인 정보 및 보안 테이블을 참조하십시오.

앱에 주소 입력 컨트롤 추가

Power Apps Studio에서 편집을 위해 앱을 연 상태에서:

  1. 삽입 탭을 열고 입력을 확장합니다.
  2. 주소 입력을 선택하여 앱 화면에 주소 입력란을 배치하거나 컨트롤을 화면으로 드래그하여 더 정확한 위치에 배치합니다. 주소 입력 컨트롤은 숫자 1개를 포함하여 3자 이상 입력해야 합니다.

기본 검색 반경 설정

기본적으로 컨트롤은 사용자 위치 주변을 검색합니다. 기본 검색 영역을 구체화하여 초기 결과의 범위를 좁힐 수 있습니다.

  1. 주소 입력 컨트롤의 속성 탭에서 Search within radius 속성을 켭니다.
  2. 경도, 위도 및 반경을 미터 단위로 입력합니다.

컨트롤은 지정된 위도와 경도에서 지정된 거리까지 검색을 시작합니다.

주소 입력 컨트롤과 함께 맵 컨트롤 사용

앱에 버튼을 추가하여 입력한 주소를 데이터 수집으로 저장할 수 있습니다. 그런 다음 주소를 검색하여 맵 컨트롤에 표시할 수 있습니다.

  1. 앱에 맵 컨트롤과 주소 입력 컨트롤을 추가합니다.

  2. 버튼 컨트롤을 삽입하고 배치합니다.

  3. 버튼 컨트롤의 OnSelect 속성을 다음과 같이 변경합니다. (힌트: 수식을 복사하여 수식 입력줄이나 고급 속성 탭 중 원하는 곳에 붙여넣습니다.)

  4. 경도, 위도 및 반경을 미터 단위로 입력합니다.

    컨트롤은 반경 필드에 지정된 거리까지 위도와 경도에서 검색을 시작합니다.

    If(IsBlank(AddressInput1.SearchResultJson), "", Collect(locations, {Latitude: AddressInput1.SelectedLatitude, Longitude: AddressInput1.SelectedLongitude}))
    

    수식은 검색 결과가 비어 있지 않은 한 현재 위도와 경도를 위치라는 컬렉션에 저장합니다.

    OnSelect 속성과 함께 표시되는 Power Apps Studio에서 생성 중인 단추의 스크린샷.

  5. 맵 컨트롤을 선택합니다. 속성을 다음과 같이 변경합니다.

    속성 이름 위치
    항목 "위치" 속성
    ItemsLatitudes "위도" 고급
    ItemsLongitudes "경도" 고급

사용자가 버튼을 선택하면 주소 입력 컨트롤의 결과가 맵에 새 핀으로 추가됩니다.

속성

속성을 사용하여 주소 입력 컨트롤의 동작과 모양을 변경합니다. 일부 속성은 고급 탭에서만 사용할 수 있습니다.

속성 설명 유형
기본 컨트롤의 초기 값을 설정합니다. 문자열 속성; 고급: 기본
힌트 텍스트 사용자가 텍스트를 입력하기 전에 컨트롤에 표시되는 힌트를 설정합니다. 문자열 속성; 고급: HintText
글꼴 컨트롤 텍스트에 사용되는 글꼴 패밀리의 이름을 설정합니다. 드롭다운 목록 속성, 고급: Font
글꼴 size 컨트롤 텍스트의 크기를 설정합니다. 부동 소수점 수 속성, 고급: FontSize
글꼴 두께 굵게, 연하게, 기본 또는 약간 굵게로 컨트롤의 텍스트 두께를 설정합니다. 드롭다운 목록 속성, 고급: FontWeight
텍스트 맞춤 가운데, 양쪽 맞춤, 왼쪽 또는 오른쪽 등 컨트롤 텍스트의 수평 맞춤을 설정합니다. 드롭다운 목록 속성, 고급: TextAlignment
줄 높이 컨트롤의 텍스트 줄 사이의 수직 거리를 설정합니다. 부동 소수점 수 속성; 고급: LineHeight
표시 모드 컨트롤이 사용자 입력을 허용할지(Edit), 데이터만 표시할지(View) 또는 비활성화할지(Disabled) 결정합니다. 드롭다운 목록 속성; 고급: DisplayMode
글꼴 스타일 기울임꼴, 밑줄, 취소선 또는 아무 설정 없이 컨트롤 텍스트의 스타일을 설정합니다. 드롭다운 목록 속성, 고급: Italic, Underline, Strikethrough
검색 결과 제한 컨트롤이 표시하는 제안된 주소의 수를 설정합니다. 정수 속성; 고급: SearchResultLimit
반경 내 검색 컨트롤이 위도경도반경 내에서 주소를 제안해야 하는지 여부를 결정합니다. 부울 속성; 고급: SearchWithinRadius
위도 주소 제안에 사용되는 중심점의 위도 좌표를 설정합니다. Search within radius이 켜져 있어야 합니다. -90에서 90 사이의 부동 소수점 숫자 속성; 고급: Latitude
경도 주소 제안에 사용되는 중심점의 경도 좌표를 설정합니다. Search within radius이 켜져 있어야 합니다. -180에서 180 사이의 부동 소수점 숫자 속성; 고급: Longitude
반경 위도경도 주위의 반경을 미터 단위로 설정하여 주소 제안을 제한합니다. Search within radius이 켜져 있어야 합니다. 부동 소수점 수 속성, 고급: Radius
언어 주소 제안이 반환되는 언어를 설정합니다. 문자열 속성; 고급: Language
국가 설정 ISO 3166 alpha-2 형식으로 주소 제안을 제한할 쉼표로 구분된 국가/지역 목록을 식별합니다. 예: US,CA,MX. 문자열 속성; 고급: CountrySet
표시됨 컨트롤을 표시하거나 숨깁니다. 부울 속성, 고급: Visible
여백 상단 컨트롤 텍스트와 컨트롤 상단 사이의 거리를 설정합니다. 부동 소수점 수 속성, 고급: PaddingTop
여백 하단 컨트롤 텍스트와 컨트롤 하단 사이의 거리를 설정합니다. 부동 소수점 수 속성, 고급: PaddingBottom
여백 왼쪽 컨트롤 텍스트와 컨트롤 왼쪽 가장자리 사이의 거리를 설정합니다. 부동 소수점 수 속성, 고급: PaddingLeft
여백 오른쪽 컨트롤 텍스트와 컨트롤 오른쪽 가장자리 사이의 거리를 설정합니다. 부동 소수점 수 속성, 고급: PaddingRight
위치 XY에 지정된 화면 좌표에 컨트롤의 왼쪽 위 모서리를 배치합니다. 정수 속성; 고급: X, Y
크기 너비높이에 제공된 픽셀 값을 사용하여 컨트롤의 크기를 결정합니다. 정수 속성; 고급: Width, Height
테두리 반지름 컨트롤 테두리의 모서리 반경을 결정합니다. 부동 소수점 수 속성, 고급: BorderRadius
색상 컨트롤 텍스트와 컨트롤 백그라운드의 색상을 설정합니다. 해당 없음 속성, 고급: FillColor, TextColor
테두리 컨트롤 테두리의 스타일, 너비 및 색상을 결정합니다. 해당 없음 속성, 고급: BorderStyle, BorderThickness, BorderColor
탭 색인 사용자가 Tab 키를 사용하여 앱을 탐색하는 경우 컨트롤이 선택되는 순서를 지정합니다. 정수 속성; 고급: TabIndex
도구 설명 사용자가 컨트롤 위로 마우스를 가져갈 때 표시할 텍스트를 결정합니다. 문자열 속성; 고급: Tooltip
가리킨 항목 색 사용자가 마우스로 가리키면 컨트롤 텍스트, 컨트롤 백그라운드 및 컨트롤 테두리의 색상을 설정합니다. 해당 없음 속성, 고급: HoverFontColor, HoverFillColor, HoverBorderColor
색 비활성화 DisplayMode비활성화된 경우 컨트롤 텍스트, 컨트롤 배경 및 컨트롤 테두리의 색상을 설정합니다. 해당 없음 속성, 고급: DisabledFontColor, DisabledFillColor, DisabledBorderColor
누른 색상 사용자가 컨트롤을 선택할 때 컨트롤 텍스트, 컨트롤 배경 및 컨트롤 테두리의 색을 설정합니다. 해당 없음 속성, 고급: PressedFontColor, PressedFillColor, PressedBorderColor
ContentLanguage 앱에서 사용되는 언어와 다른 경우 컨트롤의 표시 언어를 결정합니다. 문자열 고급
OnAddressSelect 사용자가 제안된 주소를 선택할 때 실행되는 코드를 포함합니다. 이벤트 고급
OnChange 컨트롤 속성이 변경될 때 실행되는 코드를 포함합니다. 이벤트 고급

출력 속성

다른 속성은 사용자가 주소 입력 컨트롤과 상호 작용할 때 사용할 수 있습니다. 이러한 output 속성을 다른 컨트롤에서 사용하거나 앱 경험을 사용자 지정할 수 있습니다.

속성 설명
UserInput 사용자가 입력 상자에 입력한 텍스트
SelectedLatitude 사용자가 선택한 주소의 위도
SelectedLongitude 사용자가 선택한 주소의 경도
SearchResultJson UserInput 기반의 검색 결과, JSON 형식의 문자열로 표시
FreeformAddress 사용자가 제안된 주소 목록에서 선택한 주소
LocalName 관리 단위가 아닌 주소 지정 목적으로 여러 개의 주소 지정 가능한 개체를 그룹화하는 지리적 영역 또는 지역의 이름
PostalCode 우편 번호입니다
ExtendedPostalCode 확장 우편 번호
CountryCode 국가 번호
Country 국가/지역 이름
CountryCodeISO3 ISO alpha-3 형식의 국가 번호
CountrySubdivisionName 국가/지역 하위 분류 이름
StreetName 거리 이름
StreetNumber 거리 번호
자치 도시 자치 도시
MunicipalitySubdivision 자치 도시 하위 분류
CountryTertiarySubdivision 국가/지역 3차 하위 분류
CountrySecondarySubdivision 국가/지역 2차 하위 분류
CountrySubdivision 국가/지역 하위 분류

기타 지리 공간적 컨트롤

위치 데이터를 시각화하고 해석하려면 interactive 맵 컨트롤을 사용하세요.

참고

귀사의 설명서 언어 기본 설정에 대해 말씀해 주시겠습니까? 간단한 설문 조사에 응해주세요. (이 설문 조사는 영어로 되어 있습니다.)

이 설문 조사는 약 7분 정도 걸립니다. 개인 데이터는 수집되지 않습니다(개인정보처리방침).