CSF 645 – Mobile Computing 行動計算 Google Maps Android API v 2 https: //developers. google. com/maps/documentation/android/ 吳俊興 國立高雄大學 資訊 程學系
Introduction to the Google Maps Android API v 2 • The API automatically handles – access to Google Maps servers – data downloading – map display, and – response to map gestures • Also use API calls – To add markers, polygons, and overlays to a basic map, and – To change the user's view of a particular map area 2
Google Maps Android API v 2 Improvements • Distributed as part of the Google Play services SDK • Encapsulated in the Map. Fragment class, an extension of Android's Fragment class, rather in the Activity class – Able to add a map as a piece of a larger Activity – Able to implement them by extending the Android standard Activity class, rather than extending the Map. Activity used in version 1 • Using vector tiles: data representation is smaller, with less bandwidth • Caching is improved, so users will typically see a map without empty areas. • Supporting 3 D maps 3
Overall Process of Adding a Map to an App • Step 1. Download and configure the Google Play services SDK – The Google Maps Android API is distributed as part of this SDK • Step 2. Obtain an API key – To do this, you will need to register a project in the Google APIs Console, and get a signing certificate for your app • Step 3. Specify settings in the Application Manifest • Step 4. Add a map to a new or existing Android project • Run the Sample Code - com. example. mapdemo https: //developers. google. com/maps/documentation/android/start 4
Run the Sample Code - com. example. mapdemo • Make sure Google Play services added as an Android library project 1. Select File > Import > Android > Existing Android Code Into Workspace and click Next 2. Select Browse. . . , enter <share>/google-play-services_lib, and click Finish • View the sample code, or run the sample app locally – Sample code is bundled with the Google Play services SDK 1. Select File > Import > Android > Existing Android Code Into Workspace and click Next. 2. Select Browse. . . , enter <android-sdkfolder>/extras/google_play_services/samples/maps, and click Finish 3. Select Project > Properties, select Java Build Path, and navigate to Libraries. 4. Select Add External Jars, include the following jar files, and click OK: + <androidsdk-folder>/extras/android/support/v 4/android-support-v 4. jar 5. Add your own Google Maps Android API key 6. Select Run > Run to test the sample app 5
Step 1. Setup Google Play Services SDK • To develop an app using the Google Play services APIs, download the Google Play services SDK from the SDK Manager – The download includes the client library and code samples • To test your app when using the Google Play services SDK, you must use either: – A compatible Android device that runs Android 2. 2 or higher and includes Google Play Store – The Android emulator with an AVD that runs the Google APIs platform based on Android 4. 2. 2 or higher • Three steps: – S 1 -1. Install the Google Play Services SDK – S 1 -2. Set Up a Project with the Library – S 1 -3. Ensure Devices Have the Google Play services APK http: //developer. android. com/google/play-services/setup. html 6
S 1 -1. Install the Google Play Services SDK 1. Launch the SDK Manager – From Eclipse (with ADT), select Window > Android SDK Manager 2. Install the Google Play services SDK – Saved in <android-sdk>/extras/google_play_services/ 3. Install a compatible version of the Google APIs platform – To test app on the emulator, expand the directory for Android 4. 2. 2 (API 17) or a higher version, select Google APIs, and install it 4. Make a copy of the Google Play services library project – Copy the library project at <android-sdk>/extras/google_play_services/libproject/google-playservices_lib/ to the location where you maintain your Android app projects (i. e. adt-bundle/share) – import the library project into your workspace. Click File > Import, select Android > Existing Android Code 7 into Workspace, and browse to the copy of the library project to import it
S 1 -2. Set Up a Project to Use Google Play Services SDK • Reference the library project in your Android project 1. Make sure that both the project library and the application project that depends on it are in your workspace. If one of the projects is missing, import it into your workspace 2. In the Package Explorer, right-click the dependent project and select Properties 3. In the Properties window, select the "Android" properties group at left and locate the Library properties at right 4. Click Add to open the Project Selection dialog 5. From the list of available library projects, select a project and click OK 6. When the dialog closes, click Apply in the Properties window 7. Click OK to close the Properties window 8
Step 2. Obtain an API Key • The Google Maps Android API v 2 uses a new system of managing keys – Existing keys from a Google Maps Android v 1 application, commonly known as Map. View, will not work with the v 2 API – Obtain a Maps API key from the Google APIs Console by providing the application's signing certificate and its package name – Once having the key, add it to the application by adding an element to the application's manifest file Android. Manifest. xml • Maps API keys are linked to specific certificate/package pairs – Sign each of your applications with a different certificate and get a different key for each one • Four steps: – S 2 -1: Retrieve information about your application's certificate – S 2 -2: Register a project in the Google APIs Console and add the Maps API as a service for the project – S 2 -3: Once you have a project set up, you can request one or more keys Add your key to your application and begin development 9
S 2 -1. Displaying Certificate Information • An app has two certificates – Debug certificate: only for use with an application for testing – Release certificate • SHA-1 fingerprint: a short form of application's digital certificate – Eclipse goes to Windows > Preferences > Android > Build 10
S 2 -2. Obtaining an API Key • Go to https: //code. google. com/apis/console/ 1. API Project > Services: Enable Google Maps Android API v 2 2. API Project > API Access > Create New Android Key. . 3. Enter the SHA-1 fingerprint, then a semicolon, then your application's package name 4. The Google APIs Console responds by displaying Key for Android apps (with certificates) followed by a forty-character API key 5. Copy this key value AIza. Sy. DZVhi 1 AFAq. VN 6 dj. Sp. XLq 36 dvlj. PSe. VFGU 11
S 2 -3. Adding the API Key to the Application 1. In Android. Manifest. xml, add the following element as a child of the <application> element, by inserting it just before the closing tag </application>: <meta-data android: name="com. google. android. maps. v 2. API_KEY" android: value="your_api_key"/> substituting your API key for your_api_key. This element sets the key com. google. android. maps. v 2. API_KEY to the valueyour_api_key and makes the API key visible to any Map. Fragment in your application. 2. Add the following elements to your manifest. Replace com. example. mapdemo with the package name of your application. <permission android: name="com. example. mapdemo. permission. MAPS_RECEIVE" android: protection. Level="signature"/> <uses-permission android: name="com. example. mapdemo. permission. MAPS_RECEIVE"/> 3. Save Android. Manifest. xml and re-build your application. 12
Скачать презентацию CSF 645 Mobile Computing 行動計算 Google Maps
1d17e99d5658ab5757f0ca7ff191a876.ppt