Android 6 以上的版本加上GPS地圖定位授權要求

Android 6 以上的版本在要求授權的時候是在使用該權限的當下跳出來詢問的，例如取得GPS時就會在當下需要去檢查是否有經過授權。
如果我們沒有特別提供授權的功能的話，使用者是無法使用的，除非去 Android 的應用程式設定去將定位打開（不是開啟手機的定位功能喔！）是應用程式自己可以使用定位的授權。


早期我們要取得定位服務只需要

lms = (LocationManager) getSystemService(LOCATION_SERVICE);

但是在 android 6 之後，android studio 就會要求我們要做檢查的動作：

if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) != PackageManager.PERMISSION_GRANTED && ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_COARSE_LOCATION) != PackageManager.PERMISSION_GRANTED) {
            //如果沒有授權使用定位就會跳出來這個
            // TODO: Consider calling

            //    ActivityCompat#requestPermissions
            // here to request the missing permissions, and then overriding
            //   public void onRequestPermissionsResult(int requestCode, String[] permissions,
            //                                          int[] grantResults)
            // to handle the case where the user grants the permission. See the documentation
            // for ActivityCompat#requestPermissions for more details.

            requestLocationPermission(); // 詢問使用者開啟權限
            return;
        }

如果權限沒有被開啟就會直接被 return
所以我們必須多做一段這個：

private void requestLocationPermission() {
        // 如果裝置版本是6.0（包含）以上
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
            // 取得授權狀態，參數是請求授權的名稱
            int hasPermission = checkSelfPermission(
                    Manifest.permission.ACCESS_FINE_LOCATION);

            // 如果未授權
            if (hasPermission != PackageManager.PERMISSION_GRANTED) {
                // 請求授權
                //     第一個參數是請求授權的名稱
                //     第二個參數是請求代碼
                requestPermissions(
                        new String[]{Manifest.permission.ACCESS_FINE_LOCATION},
                        REQUEST_FINE_LOCATION_PERMISSION);
            }
            else {
                // 啟動地圖與定位元件

            }
        }
    }

private static final int REQUEST_FINE_LOCATION_PERMISSION = 102;
Android 6 Tutorial 第四堂（3）讀取裝置目前的位置 - Google Services Location

Android 加入導覽說明頁面

幫自己的 APP 加上一個有 fu 的導覽頁面是個很重要的事情，因為程式本身沒 fu

我一直在尋找一個超簡單到我都會用的套件可以快速製作出來。終於被我找到了！！

網址在這：
https://github.com/PaoloRotolo/AppIntro

只需要安裝上去後，新增一個 Activity 繼承 AppIntro 在呼叫的同時直接填入內容就完成了

安裝


1.加入 build.gradle:

repositories {
    mavenCentral()
}

dependencies {
  compile 'com.github.paolorotolo:appintro:3.4.0'
}

2.加入 Manifest.xml:

<activity android:name="com.example.example.intro"
    android:label="@string/app_intro" />

建立一個 Activity

public class MyIntro extends AppIntro

當我們繼承 AppIntro 後 Android Studio 會把 onSkipPressed, onDonePressed, onSlideChanged, onNextPressed 這些動作都預先加上去。



既然我們要簡單的話就給他真的用最簡單的方法吧！基本上他是一個 Activity 去跑多個 frament 的概念。不過他可以直接讓我們用預設的所以我們只要改我們自己要顯示的資料即可喔。

 addSlide(AppIntroFragment.newInstance(title, description, image, background_colour));

這樣一行就是直接做一頁了， addSlide(AppIntroFragment.newInstance("我是標題", "我是說明文字",顯示圖檔, Color.parseColor("#背景色碼")));

google 地圖搜尋 api 鄰近地點地方資訊搜尋

在之前的
在 Android 上加上搜尋地理位置的功能 Google Places API （地方資訊挑選器 PlacePicker ）
這篇我們有提到， PlacesPicker 雖然方便但是有使用上的限制，其實 1,000 次的使用量可是一下子就用完了呢！所以官方也推薦我們直接用 JavaScript 的 API 或是 http 的 API 來使用。

這些也都是有使用限制的，不過 http 的限制額度是算在使用者自己的額度上而不是以我們的 APP 來計算所以相對非常足夠。

API 文件連結

首先我們仍然是要去申請一支api金鑰 （因為和 Android 使用的不同權限所以要另外申請喔）

接著就是重頭戲了：api 輸入和輸出的值就不解釋了，請看官方文件，有超清楚的中文範例。

要注意的有幾點：

• 這個 API 只有接受 HTTP GET 不接受 POST
• 經緯度是必填所以在呼叫這支 API 前要搭配 Android 取得經緯度範例 服用

下面是範例：

public class SearchPoi  extends AppCompatActivity {
    AQuery aQuery = new AQuery(this);
    private static final String TAG = "LocationActivity";
    GPSTracker gps;

    @Override
    protected void onCreate(Bundle savedInstanceState){
        super.onCreate(savedInstanceState);

        // 宣告使用 GPSTracker
        gps = new GPSTracker(this);
        if(gps.canGetLocation()){
            //取得經緯度
            double latitude = gps.getLatitude();
            double longitude = gps.getLongitude();
            //設定API
            String ListApi = "https://maps.googleapis.com/maps/api/place/nearbysearch/json?key="+getString(R.string.web_api_key)+"&radius=500&location=" + latitude +","+ longitude;
            
            // 呼叫 API
            aQuery.ajax(ListApi, null, JSONObject.class, new AjaxCallback() {
                @Override
                public void callback(String url, JSONObject object, AjaxStatus status) {
                    super.callback(url, object, status);
                    System.out.println("===url===" + url);
                    System.out.println("==obj==" + object);
                    System.out.println("=status=" + status);


                    try {
                        //取得地理位置名稱
                        for(int i = 0;i<=object.getJSONArray("results").length();i++){
                            Log.e("results name",object.getJSONArray("results").getJSONObject(i).getString("name"));
                        }
                    } catch (JSONException e) {
                        e.printStackTrace();
                    }

                }
            });
        }else{
            Toast.makeText(this,"error",Toast.LENGTH_SHORT).show();
        }
        

    }

}

Android 取得經緯度範例

這次寫的東西有點偷懶，是從別人家的範例拿下來呼叫的
Android GPS, Location Manager Tutorial

不過這樣可以很快的取得經緯度，所以我們還是介紹一下吧！

首先我們先到上面的網址下載這個檔案



解壓縮以後去找到 GPSTracker.java 這個檔案放到自己的專案底下。


接著就可以開始實作了，我們需要開啟以下的權限：

• ACCESS_FINE_LOCATION
• INTERNET

接著只要在自己的 Code 裡面去呼叫

    GPSTracker gps;
        gps = new GPSTracker(this);
        if(gps.canGetLocation()){

            double latitude = gps.getLatitude();
            double longitude = gps.getLongitude();

            
            Toast.makeText(getApplicationContext(), "Your Location is - \nLat: " + latitude + "\nLong: " + longitude, Toast.LENGTH_LONG).show();
        }else{
            Toast.makeText(this,"error",Toast.LENGTH_SHORT).show();
        }

就可以啦！實在是太偷懶啦～～

在 Android 上加上搜尋地理位置的功能 Google Places API （地方資訊挑選器 PlacePicker ）

google 擁有大量的店家資料以及地圖的圖資。如果不拿來運用是不是太可惜了呢？
其實 google 有提供 API 給各個平台來做串接的動作


在使用之前我們仍然需要取得憑證簽署 API 金鑰。這個部分官方寫得很詳盡我們直接看即可。
簽署與 API 金鑰

除此資外我們要在 Google Developers Console 申請 Google Places API for Android 的使用權限。這個 API 是有配額的 一天只能接受 1,000 次的查詢，如果是已經綁定信用卡的話可以增加到 150,000 次查詢。接下來應該就是要付費了吧。

開始進入正題：

這篇我們先來一個超簡單的：PlacePicker 他是經由 Intent 動作就可以呼叫的，連 UI 都不用我們自己建立。當我們呼叫後就會自動進入下面這個畫面：

包含了地圖，現在位置，周邊店家 通通都有了

---

AndroidManifest.xml

增加 ACCESS_FINE_LOCATION 權限

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

Activity上建立進入地圖的動作：

private static final int REQUEST_PLACE_PICKER = 1;


PlacePicker.IntentBuilder intentBuilder = new PlacePicker.IntentBuilder();
                Intent intent;
                try {
                    intent = intentBuilder.build(StoreAdd.this);
                    startActivityForResult(intent, REQUEST_PLACE_PICKER);
                } catch (GooglePlayServicesRepairableException | GooglePlayServicesNotAvailableException e) {
                    e.printStackTrace();
                }

Activity上建立回傳資料後的動作：

   @Override
    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
        if (requestCode == REQUEST_PLACE_PICKER){
            if (resultCode == RESULT_OK){
                Place place = PlacePicker.getPlace(data, this);

                Log.e("place", place.toString());

            }
        }
    }

如此一來當使用者點選地圖頁面上面的地點名稱後，就會回傳該地點的資料到 onActivityResult 的 Log.e 裡面。

雖然這個作法做起來超快速，但是卻不是 google 最推薦的做法。根據 google 文件上面的說法。如果我們只是要取得資料，沒有打算讓使用者在我們的 APP 上面直接建立資料給 google 其實使用 http 的 web-service 就可以摟！不過這樣的話 UI 就要很辛苦的自己做摟。

RecyclerView 加上 OnClickListener 事件監聽

繼上一篇
Android RecyclerView 簡單教學範例 後我們可以順利的顯示出 RecyclerView 的清單畫面。但是顯示出清單總是要被按的吧！應該是。

所以我們要在裡面加上 OnClickListener 的事件監聽動作。

找到 MyAdapter.java 裡面的 onBindViewHolder：

@Override
    public void onBindViewHolder(MyAdapter.ViewHolder holder, final int position) {
//            設定文字 textView 的文字為 itemsData[position].getTitle()
            holder.textView.setText(itemsData[position].getTitle());
//        設定 textView 被點擊監聽
            holder.textView.setOnClickListener(new View.OnClickListener() {
//                被點擊的動作
                @Override
                public void onClick(View v) {
//                    取得是幾個項目
                    Log.e("position", String.valueOf(position));
//                    取得點下去的那個項目的文字內容
                    Log.e("text", itemsData[position].getTitle());
                }
            });
    }

這樣就可以啦！

Android RecyclerView 簡單教學範例

RecycleView是一種進化版的 ListView 詳細的特點因為介紹很多我就先跳過了，我們來實作吧

要準備的材料有：

RecyclerView 範例檔 github 下載

Java檔案

• MainActivity.java
• MyAdapter.java
• ItemData.java

View檔案

• activity_main.xml
• item_layout.xml

Gradle

• compile 'com.android.support:recyclerview-v7:23.1.1'

---

遊戲開始： 

Layout

activity_main.xml

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="fill_parent"
    android:layout_height="match_parent"
    tools:context="com.hmkcode.android.recyclerview.MainActivity" >
 
    <android.support.v7.widget.RecyclerView
        xmlns:android="http://schemas.android.com/apk/res/android"
        xmlns:tools="http://schemas.android.com/tools"
        android:id="@+id/recyclerView"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        tools:context=".MainActivity"
    />
</RelativeLayout>

item_layout.xml

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="fill_parent"
    android:layout_height="80dp"
    android:background="@drawable/border"
    >
   <TextView
         android:id="@+id/item_title"
         android:layout_width="fill_parent"
         android:layout_height="wrap_content"
          />
</RelativeLayout>

---

JAVA

MainActivity.java

@Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        //  宣告 recyclerView
        RecyclerView recyclerView = (RecyclerView) findViewById(R.id.my_recycler_view);
        recyclerView.setLayoutManager(new LinearLayoutManager(this));
        
        // 設定要給 Adapter 的陣列為 itemsData
        ItemData itemsData[] = {
                new ItemData("hello1"),
                new ItemData("hello2"),
                new ItemData("hello3"),
        };
        
        MyAdapter mAdapter = new MyAdapter(itemsData);

        // 將 mAdapter 交給 recyclerView 顯示
recyclerView.setAdapter(mAdapter);
        recyclerView.setItemAnimator(new DefaultItemAnimator());

    }

這邊我們可以發現我們需要用到兩個 class ，分別是 ItemData 和 MyAdapter

ItemData.java

public class ItemData {
    private final String title;

    public ItemData(String title) {
        this.title = title;
    }
    public String getTitle(){
        return title;
    }
}

在上一個動作中，我們將陣列傳進去給 ItemData 。就是在 public ItemData(String title) 這邊去做接取的動作。如果每一個 ItemData 有兩個欄位的話就會是要做成 public ItemData(String key的名稱,String 第二個key的名稱)

MyAdapter.java

public class MyAdapter extends RecyclerView.Adapter {
    private ItemData[] itemsData;
    public MyAdapter(ItemData[] ItemData){ //這邊是接 MainActivity 傳進來的值
        this.itemsData = ItemData;
    }



    @Override
    public MyAdapter.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
        View itemLayoutView = LayoutInflater.from(parent.getContext()).inflate(R.layout.item_layout, null);
        ViewHolder viewHolder = new ViewHolder(itemLayoutView);
        return viewHolder;
    }

    @Override
    public void onBindViewHolder(MyAdapter.ViewHolder holder, int position) {

            // 設定 textView 的文字由 itemsData 取出，而 itemsData 的內容已經在 ItemData.java 設定好了
            holder.textView.setText(itemsData[position].getTitle());

    }

    @Override
    public int getItemCount() {

        // 顯示的數量
        return itemsData.length;
    }

    public class ViewHolder extends RecyclerView.ViewHolder {
        public TextView textView;
        public ViewHolder(View itemView) {
            super(itemView);

        // 設定 textView 為 item_title 這個 layout 物件
textView = (TextView) itemView.findViewById(R.id.item_title);
        }

    }
}

大功告成！

下一篇我們將會讓這個 RecyclerView 的清單可以執行點擊動作

RecyclerView 加上 OnClickListener 事件監聽