Y 안드로이드

Google Maps utility library란?

https://developers.google.com/maps/documentation/android-api/utility/?hl=ko

안드로이드에서 Google Maps을 사용하여 개발하다 보면 두 좌표 간 거리,  GeoJSON, KML 등 부족한 부분이 존재한다.

구글에서 이 부분을 메워줄 수 있는 공식 유틸리티 라이브러리를 제공한다.

유틸리티

지도에 GeoJSON 가져오기

지형지물을 GeoJSON 형식으로 저장하고 이 유틸리티를 사용하여 지도 위의 계층으로 렌더링할 수 있습니다. addLayer()를 호출하여 지도에 GeoJSON 데이터를 추가합니다. addFeature()를 호출하고 GeoJsonFeature 객체에 전달하여 개별 지형지물을 추가할 수도 있습니다. 자세한 내용은 Google Maps Android GeoJSON 유틸리티에 관한 문서를 참조하세요.

지도에 KML 가져오기

이 유틸리티를 사용하면 KML 객체를 지리적 셰이프로 변환하고 지도 위의 계층으로 렌더링할 수 있습니다. addLayerToMap()을 호출하여 지도에 계층을 추가합니다. Placemark, GroundOverlay, Document 또는 Folder에서 getProperties()를 호출하여 KML 객체의 속성에 액세스할 수 있습니다. 자세한 내용은 Google Maps Android KML 유틸리티에 관한 문서를 참조하세요.

지도에 열지도 추가

열지도를 사용하면 뷰어가 지도에서 데이터 지점의 분포와 상대적 강도를 쉽게 이해할 수 있습니다. 열지도는 각 위치에 마커를 배치하는 대신 색상과 셰이프를 사용하여 데이터의 분포를 나타냅니다. HeatmapTileProvider를 생성하고 지도의 관심 지점을 나타내는 LatLng 객체 컬렉션에 전달합니다. 그런 다음 새 TileOverlay를 생성하여 열지도 타일 제공자에 전달하고, 지도에 타일 오버레이를 추가합니다. 자세한 내용은 Google Maps Android 열지도 유틸리티에 관한 문서를 참조하세요.

버블 아이콘을 통해 마커 사용자 지정

IconGenerator를 추가하여 마커에 정보 조각을 표시합니다. 이 유틸리티는 마커 아이콘을 정보 창처럼 보이게 해서, 여기에 텍스트와 다른 콘텐츠를 담는 방법을 제공합니다. 정보 창은 한 번에 하나만 열 수 있지만 이 유틸리티는 하나 이상의 마커를 동시에 열 수 있다는 장점이 있습니다. 또한, 마커의 스타일을 지정하고, 마커 및/또는 콘텐츠의 방향을 변경하고, 마커의 배경 이미지/나인 패치를 변경할 수 있습니다.

마커 클러스터 관리

ClusterManager를 사용하면 다양한 확대/축소 수준에서 여러 개의 마커를 관리할 수 있습니다. 즉, 지도의 가독성을 해치지 않으면서도 지도에 많은 마커를 넣을 수 있습니다. 사용자가 높은 확대/축소 수준에서 지도를 보면, 개별 마커가 지도에 나타납니다. 사용자가 낮은 확대/축소 수준으로 축소하면, 마커가 클러스터로 모여서 지도를 보기 쉽게 해줍니다. 자세한 내용은 Google Maps Android 마커 클러스터링 유틸리티를 참조하세요.

폴리라인 인코딩 및 디코딩

PolyUtil은 인코딩된 폴리라인과 폴리곤을 경도/위도 좌표로 변환하거나 그 반대로 변환할 때 유용합니다. Google 지도에서 폴리라인이나 폴리곤을 정의하는 경도와 위도 좌표는 인코딩된 문자열로 저장됩니다. 폴리라인 인코딩에 대한 자세한 설명을 참조하세요. Google Maps Directions API와 같은 Google API의 응답에서 이 인코딩된 문자열을 수신할 수 있습니다. Google Maps Android API 유틸리티 라이브러리에서 PolyUtil을 사용하여 일련의 경도/위도 좌표('LatLngs')를 인코딩된 경로 문자열로 인코딩하고, 인코딩된 경로 문자열을 일련의 LatLngs로 디코딩/인코딩할 수 있습니다. 이는 Google Maps API 웹 서비스와의 상호운용성을 보장합니다.

구면 기하학을 통해 거리, 영역 및 방향 계산

SphericalUtil의 구면 기하학 유틸리티를 사용하여 경도와 위도를 기반으로 거리, 영역, 방향을 계산할 수 있습니다. 다음은 유틸리티에서 사용할 수 있는 몇 가지 메서드입니다. computeDistanceBetween() – 두 개의 위도/경도 좌표 사이의 거리를 미터 단위로 반환합니다. computeHeading() – 두 개의 위도/경도 좌표 사이의 베어링을 도 단위로 반환합니다. computeArea() – 지구 위의 닫힌 경로의 영역을 제곱미터 단위로 반환합니다. interpolate() – 주어진 두 지점 사이의 거리에서 지정된 부분에 있는 지점의 경도/위도 좌표를 반환합니다. 예를 들어, 이 메서드를 사용하여 두 지점 사이의 마커를 애니메이트할 수 있습니다. 유틸리티에 포함된 메서드의 전체 목록은 참조 문서를 참조하세요.

GitHub : https://github.com/googlemaps/android-maps-utils

Constraint Layout을 이용하여 간단한 이동 애니메이션을 구현할 수 있다.

먼저 Constraint Layout을 어떤식으로 사용하는지 알아야 하기 때문에 모를 경우 배우고 난 뒤 읽는 것을 추천

결과물

1. Floating action button을 Constraint Layout에 넣기

<android.support.constraint.ConstraintLayout
    android:id="@+id/menu_layout"
    android:layout_width="wrap_content"
    android:layout_height="match_parent"
    android:layout_gravity="bottom|end" >

    <android.support.design.widget.FloatingActionButton
        android:id="@+id/fab1"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_margin="@dimen/fab_margin"
        android:layout_marginBottom="8dp"
        android:layout_marginEnd="8dp"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:srcCompat="@android:drawable/ic_dialog_alert"
        app:fabSize="mini" />

    <android.support.design.widget.FloatingActionButton
        android:id="@+id/fab2"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_margin="@dimen/fab_margin"
        android:layout_marginBottom="8dp"
        android:layout_marginEnd="8dp"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:srcCompat="@android:drawable/ic_dialog_info"
        app:fabSize="mini" />

    <android.support.design.widget.FloatingActionButton
        android:id="@+id/fab"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_margin="@dimen/fab_margin"
        android:layout_marginBottom="8dp"
        android:layout_marginEnd="8dp"
        android:layout_marginStart="8dp"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:srcCompat="@android:drawable/ic_dialog_email" />

</android.support.constraint.ConstraintLayout>

fab은 메뉴 버튼, fab1과 fab2는 fab을 누를 시 나오는 항목들

2. fab 버튼 이벤트 구현

class MainActivity : AppCompatActivity() {

    private var isMenuCollapsed = true

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        setSupportActionBar(toolbar)

        fab.setOnClickListener { view ->
            val constraintSet = ConstraintSet()
            constraintSet.clone(menu_layout)

            if(isMenuCollapsed) {
                // Set fab1's position to top of fab
                constraintSet.connect(fab1.id, ConstraintSet.BOTTOM, fab.id, ConstraintSet.TOP)
                // Set fab2's position to top of fab1
                constraintSet.connect(fab2.id, ConstraintSet.BOTTOM, fab1.id, ConstraintSet.TOP)
            }
            else {
                // Set fab1's position back to bottom
                constraintSet.connect(fab1.id, ConstraintSet.BOTTOM, fab.id, ConstraintSet.BOTTOM)
                // Set fab2's position back to bottom
                constraintSet.connect(fab2.id, ConstraintSet.BOTTOM, fab.id, ConstraintSet.BOTTOM)
            }
            val transition = AutoTransition()
            transition.duration = 300
            transition.interpolator = AccelerateDecelerateInterpolator()

            TransitionManager.beginDelayedTransition(menu_layout, transition)
            constraintSet.applyTo(menu_layout)

            isMenuCollapsed = !isMenuCollapsed
        }
    }

    override fun onCreateOptionsMenu(menu: Menu): Boolean {
        // Inflate the menu; this adds items to the action bar if it is present.
        menuInflater.inflate(R.menu.menu_main, menu)
        return true
    }

    override fun onOptionsItemSelected(item: MenuItem): Boolean {
        // Handle action bar item clicks here. The action bar will
        // automatically handle clicks on the Home/Up button, so long
        // as you specify a parent activity in AndroidManifest.xml.
        return when (item.itemId) {
            R.id.action_settings -> true
            else -> super.onOptionsItemSelected(item)
        }
    }
}

이 방법은 menu_layout의 클론(constraintSet)을 만들고 fab1과 fab2의 새로운 위치를 지정 해주고 Transition을 한다. 결과적으로는 두 개의 menu_layout을 통해 애니메이션을 구현한 것이다.

Constraint를 잘 활용하면 예제처럼 아래서 위로 가는 것뿐만 아니라 오른쪽에서 왼쪽 또는 대각선 까지 다양한 방향 전환이 가능하다.

GitHub : https://github.com/Hot6ix/FloatingActionButton

참조 : https://robinhood.engineering/beautiful-animations-using-android-constraintlayout-eee5b72ecae3

1. 기본 환경 세팅

- 두 액티비티 모두 Google Map 적용

- 사용자지정 액태비티 전환을 위한 코드 삽입

https://developer.android.com/training/material/animations.html?hl=ko#Transitions

2. Google Map에 적용

두 액티비티의 소스 코드 중 초기 Google Map Fragment를 가져오는 부분에 추가

val mapFragment = supportFragmentManager
        .findFragmentById(R.id.map) as SupportMapFragment
mapFragment.view!!.transitionName = resources.getString(R.string.shared_element_map)

Fragment의 View를 가져와 TransitionName을 넣는다. 

넣은 후 액티비티 전환을 위한 Intent의 Options을 정의할 때 다음과 같이 추가한다.

var options = ActivityOptionsCompat.makeSceneTransitionAnimation(this,
        Pair<View, String>(map.view, ViewCompat.getTransitionName(map.view)))

Kotlin으로 작성된 커스텀 리스트뷰 예제

MainActivity.kt

import android.content.Context
import android.os.Bundle
import android.support.v7.app.AppCompatActivity
import android.view.LayoutInflater
import android.view.View
import android.view.ViewGroup
import android.widget.BaseAdapter
import android.widget.TextView
import kotlinx.android.synthetic.main.activity_main.*

class MainActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        val list: ArrayList<CustomItem> = ArrayList()
        list.add(CustomItem("James", 23, "Male"))
        list.add(CustomItem("Jamie", 20, "Female"))
        list.add(CustomItem("John", 30, "Male"))

        listview1.adapter = CustomAdapter(this, list)
    }

    private class CustomAdapter(context: Context, array: ArrayList<CustomItem>): BaseAdapter() {

        private var list: ArrayList<CustomItem> = array
        private var inflater: LayoutInflater = LayoutInflater.from(context)

        override fun getView(p0: Int, p1: View?, p2: ViewGroup?): View {

            val view: View?
            val viewHolder: ViewHolder

            if(p1 == null) {
                view = this.inflater.inflate(R.layout.listview_item, p2,false)
                viewHolder = ViewHolder(view)
                view.tag = viewHolder
            }
            else {
                view = p1
                viewHolder = view.tag as ViewHolder
            }

            viewHolder.name.text = list[p0].name
            viewHolder.age.text = list[p0].age.toString()
            viewHolder.gender.text = list[p0].gender

            return view!!
        }

        override fun getItem(p0: Int): Any {
            return list[p0]
        }

        override fun getItemId(p0: Int): Long {
            return p0.toLong()
        }

        override fun getCount(): Int {
            return list.size
        }

    }

    private class ViewHolder(view: View?) {

        val name: TextView = view?.findViewById(R.id.nameTextView) as TextView
        val age: TextView = view?.findViewById(R.id.ageTextView) as TextView
        val gender: TextView = view?.findViewById(R.id.genderTextView) as TextView
    }

    data class CustomItem(var name: String, var age: Int, var gender: String)
}

listview_item.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <TextView
        android:id="@+id/nameTextView"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_weight="1"
        android:text="TextView" />

    <TextView
        android:id="@+id/ageTextView"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_weight="1"
        android:text="TextView" />

    <TextView
        android:id="@+id/genderTextView"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_weight="1"
        android:text="TextView" />
</LinearLayout>

GitHub : https://github.com/Hot6ix/SimpleCustomListView

Volley를 이용하여 간단한 HTTP 통신을 하는 예제이다.

1. AndroidManifest.xml 에서 권한 명시 

<uses-permission android:name="android.permission.INTERNET" />

2. build.gradle 내  dependencies 에 Volley 사용을 위한 명시

compile 'com.android.volley:volley:1.1.0'

3. Build - Make Project 를 하여 프로젝트에서 Volley 사용 가능

4. HTTP 통신 예제

import android.os.Bundle
import android.support.v7.app.AppCompatActivity
import android.util.Log.i
import com.android.volley.Request
import com.android.volley.RequestQueue
import com.android.volley.Response
import com.android.volley.toolbox.StringRequest
import com.android.volley.toolbox.Volley
import kotlinx.android.synthetic.main.activity_main.*

class MainActivity : AppCompatActivity() {

    lateinit var request: RequestQueue
    lateinit var stringRequest: StringRequest

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        // Setup RequestQueue
        request = Volley.newRequestQueue(this)
        val url = "http://www.google.com"

        // Setup StringRequest
        stringRequest = StringRequest(Request.Method.GET, url, Response.Listener<String> {
            response -> textView1.text = response // Print http source using textview
        }, Response.ErrorListener {
            error ->  i(applicationContext.packageName, error.toString()) // Print log if error occurred
        })

        // Set tag for cancel
        stringRequest.tag = applicationContext.packageName
        // Request
        request.add(stringRequest)
    }

    override fun onStop() {
        super.onStop()

        // Cancel all request that have packageName tag
        if(request != null) {
            request.cancelAll(applicationContext.packageName)
        }
    }
}

GitHub : https://github.com/Hot6ix/SimpleHttpRequest

출처 : https://developer.android.com/training/volley/simple.html

안드로이드 6.0 이후부터는 일부 권한의 경우 단순히 AndroidManifest.xml 에 명시하더라도 작동이 되지 않는다.

설치될 때 권한을 부여하는 것이 아니라 실행되는 도중 런타임에 권한을 요청하기 때문이다.

하지만 여전히 AndroidManifest.xml 에 권한을 명시해야 한다.

예제의 경우 주소록 읽기 권한을 요청한다.

권한 요청

if (ContextCompat.checkSelfPermission(thisActivity,
                Manifest.permission.READ_CONTACTS)
        != PackageManager.PERMISSION_GRANTED) {

        // 권한이 없으므로 요청
        ActivityCompat.requestPermissions(thisActivity,
                new String[]{Manifest.permission.READ_CONTACTS},
                MY_PERMISSIONS_REQUEST_READ_CONTACTS);

        // MY_PERMISSIONS_REQUEST_READ_CONTACTS 의 경우 사용자 정의 값으로
        // 응답 처리에 필요
}

응답 처리

@Override
public void onRequestPermissionsResult(int requestCode,
        String permissions[], int[] grantResults) {
    switch (requestCode) {
        case MY_PERMISSIONS_REQUEST_READ_CONTACTS: {
            // If request is cancelled, the result arrays are empty.
            if (grantResults.length > 0
                && grantResults[0] == PackageManager.PERMISSION_GRANTED) {

                // 권한 획득

            } else {

                // 권한 획득 실패
            }
            return;
        }

        // other 'case' lines to check for other
        // permissions this app might request
    }
}

별도의 요청이 필요한 권한 목록

출처 : https://developer.android.com/training/permissions/requesting.html?hl=ko