├── app ├── .gitignore ├── src │ └── main │ │ ├── res │ │ ├── mipmap-hdpi │ │ │ └── ic_launcher.png │ │ ├── mipmap-mdpi │ │ │ └── ic_launcher.png │ │ ├── mipmap-xhdpi │ │ │ └── ic_launcher.png │ │ ├── mipmap-xxhdpi │ │ │ └── ic_launcher.png │ │ ├── mipmap-xxxhdpi │ │ │ └── ic_launcher.png │ │ ├── menu │ │ │ └── main.xml │ │ ├── drawable │ │ │ └── magnitude_circle.xml │ │ ├── layout │ │ │ ├── settings_activity.xml │ │ │ ├── earthquake_activity.xml │ │ │ └── earthquake_list_item.xml │ │ ├── xml │ │ │ └── settings_main.xml │ │ └── values │ │ │ ├── styles.xml │ │ │ ├── strings.xml │ │ │ └── colors.xml │ │ ├── java │ │ └── com │ │ │ └── example │ │ │ └── android │ │ │ └── quakereport │ │ │ ├── Earthquake.java │ │ │ ├── EarthquakeLoader.java │ │ │ ├── SettingsActivity.java │ │ │ ├── EarthquakeAdapter.java │ │ │ ├── QueryUtils.java │ │ │ └── EarthquakeActivity.java │ │ └── AndroidManifest.xml ├── build.gradle └── proguard-rules.pro ├── settings.gradle ├── gradle └── wrapper │ ├── gradle-wrapper.jar │ └── gradle-wrapper.properties ├── gradle.properties ├── CONTRIBUTING.md ├── README.md ├── .gitignore ├── gradlew.bat ├── gradlew └── LICENSE /app/.gitignore: -------------------------------------------------------------------------------- 1 | /build 2 | -------------------------------------------------------------------------------- /settings.gradle: -------------------------------------------------------------------------------- 1 | include ':app' 2 | -------------------------------------------------------------------------------- /gradle/wrapper/gradle-wrapper.jar: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/bots/Quakereport-App/master/gradle/wrapper/gradle-wrapper.jar -------------------------------------------------------------------------------- /app/src/main/res/mipmap-hdpi/ic_launcher.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/bots/Quakereport-App/master/app/src/main/res/mipmap-hdpi/ic_launcher.png -------------------------------------------------------------------------------- /app/src/main/res/mipmap-mdpi/ic_launcher.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/bots/Quakereport-App/master/app/src/main/res/mipmap-mdpi/ic_launcher.png -------------------------------------------------------------------------------- /app/src/main/res/mipmap-xhdpi/ic_launcher.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/bots/Quakereport-App/master/app/src/main/res/mipmap-xhdpi/ic_launcher.png -------------------------------------------------------------------------------- /app/src/main/res/mipmap-xxhdpi/ic_launcher.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/bots/Quakereport-App/master/app/src/main/res/mipmap-xxhdpi/ic_launcher.png -------------------------------------------------------------------------------- /app/src/main/res/mipmap-xxxhdpi/ic_launcher.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/bots/Quakereport-App/master/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png -------------------------------------------------------------------------------- /gradle/wrapper/gradle-wrapper.properties: -------------------------------------------------------------------------------- 1 | #Sat Feb 10 20:52:56 MST 2018 2 | distributionBase=GRADLE_USER_HOME 3 | distributionPath=wrapper/dists 4 | zipStoreBase=GRADLE_USER_HOME 5 | zipStorePath=wrapper/dists 6 | distributionUrl=https\://services.gradle.org/distributions/gradle-4.1-all.zip 7 | -------------------------------------------------------------------------------- /app/src/main/res/menu/main.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 6 | 9 | 10 | -------------------------------------------------------------------------------- /app/src/main/res/drawable/magnitude_circle.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 5 | 6 | 9 | 10 | 11 | -------------------------------------------------------------------------------- /app/src/main/res/layout/settings_activity.xml: -------------------------------------------------------------------------------- 1 | 2 | 9 | 10 | -------------------------------------------------------------------------------- /app/src/main/res/xml/settings_main.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 6 | 7 | 13 | 14 | 15 | -------------------------------------------------------------------------------- /app/build.gradle: -------------------------------------------------------------------------------- 1 | apply plugin: 'com.android.application' 2 | 3 | android { 4 | compileSdkVersion 23 5 | buildToolsVersion '26.0.2' 6 | 7 | defaultConfig { 8 | applicationId "com.example.android.quakereport" 9 | minSdkVersion 15 10 | targetSdkVersion 23 11 | versionCode 1 12 | versionName "1.0" 13 | } 14 | buildTypes { 15 | release { 16 | minifyEnabled false 17 | proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' 18 | } 19 | } 20 | } 21 | 22 | dependencies { 23 | compile fileTree(dir: 'libs', include: ['*.jar']) 24 | testCompile 'junit:junit:4.12' 25 | compile 'com.android.support:appcompat-v7:23.3.0' 26 | } 27 | -------------------------------------------------------------------------------- /app/proguard-rules.pro: -------------------------------------------------------------------------------- 1 | # Add project specific ProGuard rules here. 2 | # By default, the flags in this file are appended to flags specified 3 | # in /Users/katherinekuan/Library/Android/sdk/tools/proguard/proguard-android.txt 4 | # You can edit the include path and order by changing the proguardFiles 5 | # directive in build.gradle. 6 | # 7 | # For more details, see 8 | # http://developer.android.com/guide/developing/tools/proguard.html 9 | 10 | # Add any project specific keep options here: 11 | 12 | # If your project uses WebView with JS, uncomment the following 13 | # and specify the fully qualified class name to the JavaScript interface 14 | # class: 15 | #-keepclassmembers class fqcn.of.javascript.interface.for.webview { 16 | # public *; 17 | #} 18 | -------------------------------------------------------------------------------- /gradle.properties: -------------------------------------------------------------------------------- 1 | # Project-wide Gradle settings. 2 | 3 | # IDE (e.g. Android Studio) users: 4 | # Gradle settings configured through the IDE *will override* 5 | # any settings specified in this file. 6 | 7 | # For more details on how to configure your build environment visit 8 | # http://www.gradle.org/docs/current/userguide/build_environment.html 9 | 10 | # Specifies the JVM arguments used for the daemon process. 11 | # The setting is particularly useful for tweaking memory settings. 12 | # Default value: -Xmx10248m -XX:MaxPermSize=256m 13 | # org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m -XX:+HeapDumpOnOutOfMemoryError -Dfile.encoding=UTF-8 14 | 15 | # When configured, Gradle will run in incubating parallel mode. 16 | # This option should only be used with decoupled projects. More details, visit 17 | # http://www.gradle.org/docs/current/userguide/multi_project_builds.html#sec:decoupled_projects 18 | # org.gradle.parallel=true -------------------------------------------------------------------------------- /app/src/main/java/com/example/android/quakereport/Earthquake.java: -------------------------------------------------------------------------------- 1 | package com.example.android.quakereport; 2 | 3 | /** 4 | * Created by bots on 2/10/18. 5 | */ 6 | 7 | public class Earthquake { 8 | 9 | private String mUrl; 10 | 11 | private double mMagnitude; 12 | 13 | private String mLocation; 14 | 15 | private long mTimeInMilliseconds; 16 | 17 | public Earthquake(double magnitude, String location, long timeInMilliseconds, String url){ 18 | mMagnitude = magnitude; 19 | mLocation = location; 20 | mTimeInMilliseconds = timeInMilliseconds; 21 | mUrl = url; 22 | } 23 | 24 | public double getMagnitude(){ 25 | return mMagnitude; 26 | } 27 | 28 | public String getLocation(){ 29 | return mLocation; 30 | } 31 | 32 | public long getTimeInMilliseconds(){ 33 | return mTimeInMilliseconds; 34 | } 35 | 36 | public String getUrl(){ 37 | return mUrl; 38 | } 39 | } 40 | -------------------------------------------------------------------------------- /app/src/main/res/values/styles.xml: -------------------------------------------------------------------------------- 1 | 2 | 16 | 17 | 18 | 19 | 24 | 25 | 26 | -------------------------------------------------------------------------------- /app/src/main/java/com/example/android/quakereport/EarthquakeLoader.java: -------------------------------------------------------------------------------- 1 | package com.example.android.quakereport; 2 | 3 | import android.content.AsyncTaskLoader; 4 | import android.content.Context; 5 | 6 | import java.util.List; 7 | 8 | /** 9 | * Created by bots on 2/18/18. 10 | */ 11 | 12 | public class EarthquakeLoader extends AsyncTaskLoader> { 13 | 14 | /** Tag for log messages */ 15 | private static final String LOG_TAG = EarthquakeLoader.class.getName(); 16 | 17 | /** Query URL */ 18 | private String mUrl; 19 | 20 | /** 21 | * Constructs a new {@link EarthquakeLoader}. 22 | * 23 | * @param context of the activity 24 | * @param url to load data from 25 | */ 26 | public EarthquakeLoader(Context context, String url) { 27 | super(context); 28 | mUrl = url; 29 | } 30 | 31 | @Override 32 | protected void onStartLoading() { 33 | forceLoad(); 34 | } 35 | 36 | /** 37 | * This is on a background thread. 38 | */ 39 | @Override 40 | public List loadInBackground() { 41 | if (mUrl == null) { 42 | return null; 43 | } 44 | 45 | // Perform the network request, parse the response, and extract a list of earthquakes. 46 | List earthquakes = QueryUtils.fetchEarthquakeData(mUrl); 47 | return earthquakes; 48 | } 49 | } 50 | -------------------------------------------------------------------------------- /CONTRIBUTING.md: -------------------------------------------------------------------------------- 1 | # How to become a contributor and submit your own code 2 | 3 | ## Contributor License Agreements 4 | 5 | We'd love to accept your sample apps and patches! Before we can take them, we 6 | have to jump a couple of legal hurdles. 7 | 8 | Please fill out either the individual or corporate Contributor License Agreement 9 | (CLA). 10 | 11 | * If you are an individual writing original source code and you're sure you 12 | own the intellectual property, then you'll need to sign an [individual CLA] 13 | (https://developers.google.com/open-source/cla/individual). 14 | * If you work for a company that wants to allow you to contribute your work, 15 | then you'll need to sign a [corporate CLA] 16 | (https://developers.google.com/open-source/cla/corporate). 17 | 18 | Follow either of the two links above to access the appropriate CLA and 19 | instructions for how to sign and return it. Once we receive it, we'll be able to 20 | accept your pull requests. 21 | 22 | ## Contributing A Patch 23 | 24 | 1. Submit an issue describing your proposed change to the repo in question. 25 | 1. The repo owner will respond to your issue promptly. 26 | 1. If your proposed change is accepted, and you haven't already done so, sign a 27 | Contributor License Agreement (see details above). 28 | 1. Fork the desired repo, develop and test your code changes. 29 | 1. Ensure that your code adheres to the existing style in the sample to which 30 | you are contributing. Refer to the 31 | [Google Cloud Platform Samples Style Guide] 32 | (https://github.com/GoogleCloudPlatform/Template/wiki/style.html) for the 33 | recommended coding standards for this organization. 34 | 1. Ensure that your code has an appropriate set of unit tests which all pass. 35 | 1. Submit a pull request. 36 | 37 | -------------------------------------------------------------------------------- /app/src/main/res/values/strings.xml: -------------------------------------------------------------------------------- 1 | 15 | 16 | Quake Report 17 | 18 | 20 | Near the 21 | 22 | 23 | No earthquakes found. 24 | 25 | 26 | No internet connection. 27 | 28 | Settings 29 | Earthquake Settings 30 | 31 | Minimum Magnitude 32 | min_magnitude 33 | 0 34 | 35 | 36 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | Quake Report App 2 | =================================== 3 | 4 | This app displays a list of recent earthquakes in the world 5 | from the U.S. Geological Survey (USGS) organization. 6 | 7 | Used in a Udacity course in the Beginning Android Nanodegree. 8 | 9 | More info on the USGS Earthquake API available at: 10 | https://earthquake.usgs.gov/fdsnws/event/1/ 11 | 12 | Pre-requisites 13 | -------------- 14 | 15 | - Android SDK v23 16 | - Android Build Tools v23.0.2 17 | - Android Support Repository v23.3.0 18 | 19 | Getting Started 20 | --------------- 21 | 22 | This sample uses the Gradle build system. To build this project, use the 23 | "gradlew build" command or use "Import Project" in Android Studio. 24 | 25 | Support 26 | ------- 27 | 28 | - Google+ Community: https://plus.google.com/communities/105153134372062985968 29 | - Stack Overflow: http://stackoverflow.com/questions/tagged/android 30 | 31 | Patches are encouraged, and may be submitted by forking this project and 32 | submitting a pull request through GitHub. Please see CONTRIBUTING.md for more details. 33 | 34 | License 35 | ------- 36 | 37 | Copyright 2016 The Android Open Source Project, Inc. 38 | 39 | Licensed to the Apache Software Foundation (ASF) under one or more contributor 40 | license agreements. See the NOTICE file distributed with this work for 41 | additional information regarding copyright ownership. The ASF licenses this 42 | file to you under the Apache License, Version 2.0 (the "License"); you may not 43 | use this file except in compliance with the License. You may obtain a copy of 44 | the License at 45 | 46 | http://www.apache.org/licenses/LICENSE-2.0 47 | 48 | Unless required by applicable law or agreed to in writing, software 49 | distributed under the License is distributed on an "AS IS" BASIS, WITHOUT 50 | WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the 51 | License for the specific language governing permissions and limitations under 52 | the License. 53 | -------------------------------------------------------------------------------- /app/src/main/res/layout/earthquake_activity.xml: -------------------------------------------------------------------------------- 1 | 2 | 16 | 17 | 21 | 22 | 29 | 30 | 31 | 37 | 38 | 39 | 45 | 46 | -------------------------------------------------------------------------------- /app/src/main/AndroidManifest.xml: -------------------------------------------------------------------------------- 1 | 16 | 18 | 19 | 20 | 21 | 22 | 28 | 29 | 30 | 31 | 32 | 33 | 34 | 35 | 36 | 40 | 43 | 44 | 45 | 46 | 47 | -------------------------------------------------------------------------------- /app/src/main/java/com/example/android/quakereport/SettingsActivity.java: -------------------------------------------------------------------------------- 1 | package com.example.android.quakereport; 2 | 3 | import android.content.SharedPreferences; 4 | import android.os.Bundle; 5 | import android.preference.Preference; 6 | import android.preference.PreferenceFragment; 7 | import android.preference.PreferenceManager; 8 | import android.support.annotation.Nullable; 9 | import android.support.v7.app.AppCompatActivity; 10 | 11 | /** 12 | * Created by bots on 2/21/18. 13 | */ 14 | 15 | public class SettingsActivity extends AppCompatActivity{ 16 | 17 | @Override 18 | protected void onCreate(@Nullable Bundle savedInstanceState) { 19 | super.onCreate(savedInstanceState); 20 | setContentView(R.layout.settings_activity); 21 | } 22 | 23 | public static class EarthquakePreferenceFragment extends PreferenceFragment 24 | implements Preference.OnPreferenceChangeListener{ 25 | 26 | @Override 27 | public void onCreate(@Nullable Bundle savedInstanceState) { 28 | super.onCreate(savedInstanceState); 29 | addPreferencesFromResource(R.xml.settings_main); 30 | 31 | Preference minMagnitude = findPreference(getString(R.string.settings_min_magnitude_key)); 32 | bindPreferenceSummaryToValue(minMagnitude); 33 | } 34 | 35 | @Override 36 | public boolean onPreferenceChange(Preference preference, Object value) { 37 | String stringValue = value.toString(); 38 | preference.setSummary(stringValue); 39 | return true; 40 | } 41 | 42 | private void bindPreferenceSummaryToValue(Preference preference) { 43 | preference.setOnPreferenceChangeListener(this); 44 | SharedPreferences preferences = PreferenceManager.getDefaultSharedPreferences(preference.getContext()); 45 | String preferenceString = preferences.getString(preference.getKey(), ""); 46 | onPreferenceChange(preference, preferenceString); 47 | } 48 | } 49 | } 50 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | ### JetBrains template 2 | # Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion 3 | 4 | *.iml 5 | 6 | ## Directory-based project format: 7 | .idea/ 8 | # if you remove the above rule, at least ignore the following: 9 | 10 | # User-specific stuff: 11 | # .idea/workspace.xml 12 | # .idea/tasks.xml 13 | # .idea/dictionaries 14 | 15 | # Sensitive or high-churn files: 16 | # .idea/dataSources.ids 17 | # .idea/dataSources.xml 18 | # .idea/sqlDataSources.xml 19 | # .idea/dynamic.xml 20 | # .idea/uiDesigner.xml 21 | 22 | # Gradle: 23 | # .idea/gradle.xml 24 | # .idea/libraries 25 | 26 | # Mongo Explorer plugin: 27 | # .idea/mongoSettings.xml 28 | 29 | ## File-based project format: 30 | *.ipr 31 | *.iws 32 | 33 | ## Plugin-specific files: 34 | 35 | # IntelliJ 36 | /out/ 37 | 38 | # mpeltonen/sbt-idea plugin 39 | .idea_modules/ 40 | 41 | # JIRA plugin 42 | atlassian-ide-plugin.xml 43 | 44 | # Crashlytics plugin (for Android Studio and IntelliJ) 45 | com_crashlytics_export_strings.xml 46 | crashlytics.properties 47 | crashlytics-build.properties 48 | 49 | 50 | ### OSX template 51 | .DS_Store 52 | .AppleDouble 53 | .LSOverride 54 | 55 | # Icon must end with two \r 56 | Icon 57 | 58 | # Thumbnails 59 | ._* 60 | 61 | # Files that might appear in the root of a volume 62 | .DocumentRevisions-V100 63 | .fseventsd 64 | .Spotlight-V100 65 | .TemporaryItems 66 | .Trashes 67 | .VolumeIcon.icns 68 | 69 | # Directories potentially created on remote AFP share 70 | .AppleDB 71 | .AppleDesktop 72 | Network Trash Folder 73 | Temporary Items 74 | .apdisk 75 | 76 | 77 | ### Android template 78 | # Built application files 79 | *.apk 80 | *.ap_ 81 | 82 | # Files for the Dalvik VM 83 | *.dex 84 | 85 | # Java class files 86 | *.class 87 | 88 | # Generated files 89 | bin/ 90 | gen/ 91 | 92 | # Gradle files 93 | .gradle/ 94 | build/ 95 | /*/build/ 96 | 97 | # Local configuration file (sdk path, etc) 98 | local.properties 99 | 100 | # Proguard folder generated by Eclipse 101 | proguard/ 102 | -------------------------------------------------------------------------------- /gradlew.bat: -------------------------------------------------------------------------------- 1 | @if "%DEBUG%" == "" @echo off 2 | @rem ########################################################################## 3 | @rem 4 | @rem Gradle startup script for Windows 5 | @rem 6 | @rem ########################################################################## 7 | 8 | @rem Set local scope for the variables with windows NT shell 9 | if "%OS%"=="Windows_NT" setlocal 10 | 11 | @rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. 12 | set DEFAULT_JVM_OPTS= 13 | 14 | set DIRNAME=%~dp0 15 | if "%DIRNAME%" == "" set DIRNAME=. 16 | set APP_BASE_NAME=%~n0 17 | set APP_HOME=%DIRNAME% 18 | 19 | @rem Find java.exe 20 | if defined JAVA_HOME goto findJavaFromJavaHome 21 | 22 | set JAVA_EXE=java.exe 23 | %JAVA_EXE% -version >NUL 2>&1 24 | if "%ERRORLEVEL%" == "0" goto init 25 | 26 | echo. 27 | echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 28 | echo. 29 | echo Please set the JAVA_HOME variable in your environment to match the 30 | echo location of your Java installation. 31 | 32 | goto fail 33 | 34 | :findJavaFromJavaHome 35 | set JAVA_HOME=%JAVA_HOME:"=% 36 | set JAVA_EXE=%JAVA_HOME%/bin/java.exe 37 | 38 | if exist "%JAVA_EXE%" goto init 39 | 40 | echo. 41 | echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% 42 | echo. 43 | echo Please set the JAVA_HOME variable in your environment to match the 44 | echo location of your Java installation. 45 | 46 | goto fail 47 | 48 | :init 49 | @rem Get command-line arguments, handling Windowz variants 50 | 51 | if not "%OS%" == "Windows_NT" goto win9xME_args 52 | if "%@eval[2+2]" == "4" goto 4NT_args 53 | 54 | :win9xME_args 55 | @rem Slurp the command line arguments. 56 | set CMD_LINE_ARGS= 57 | set _SKIP=2 58 | 59 | :win9xME_args_slurp 60 | if "x%~1" == "x" goto execute 61 | 62 | set CMD_LINE_ARGS=%* 63 | goto execute 64 | 65 | :4NT_args 66 | @rem Get arguments from the 4NT Shell from JP Software 67 | set CMD_LINE_ARGS=%$ 68 | 69 | :execute 70 | @rem Setup the command line 71 | 72 | set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar 73 | 74 | @rem Execute Gradle 75 | "%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %CMD_LINE_ARGS% 76 | 77 | :end 78 | @rem End local scope for the variables with windows NT shell 79 | if "%ERRORLEVEL%"=="0" goto mainEnd 80 | 81 | :fail 82 | rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of 83 | rem the _cmd.exe /c_ return code! 84 | if not "" == "%GRADLE_EXIT_CONSOLE%" exit 1 85 | exit /b 1 86 | 87 | :mainEnd 88 | if "%OS%"=="Windows_NT" endlocal 89 | 90 | :omega 91 | -------------------------------------------------------------------------------- /app/src/main/res/values/colors.xml: -------------------------------------------------------------------------------- 1 | 2 | 16 | 17 | 18 | #2B3D4D 19 | 20 | 21 | #23303D 22 | 23 | 24 | #10CAC9 25 | 26 | 27 | #4A7BA7 28 | 29 | 30 | #04B4B3 31 | 32 | 33 | #10CAC9 34 | 35 | 36 | #F5A623 37 | 38 | 39 | #FF7D50 40 | 41 | 42 | #FC6644 43 | 44 | 45 | #E75F40 46 | 47 | 48 | #E13A20 49 | 50 | 51 | #D93218 52 | 53 | 54 | #C03823 55 | 56 | 57 | #B4BAC0 58 | 59 | 60 | #2B3D4D 61 | 62 | 63 | -------------------------------------------------------------------------------- /app/src/main/res/layout/earthquake_list_item.xml: -------------------------------------------------------------------------------- 1 | 2 | 11 | 12 | 23 | 24 | 32 | 33 | 44 | 45 | 54 | 55 | 56 | 57 | 64 | 65 | 73 | 74 | 82 | 83 | 84 | 85 | -------------------------------------------------------------------------------- /gradlew: -------------------------------------------------------------------------------- 1 | #!/usr/bin/env bash 2 | 3 | ############################################################################## 4 | ## 5 | ## Gradle start up script for UN*X 6 | ## 7 | ############################################################################## 8 | 9 | # Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. 10 | DEFAULT_JVM_OPTS="" 11 | 12 | APP_NAME="Gradle" 13 | APP_BASE_NAME=`basename "$0"` 14 | 15 | # Use the maximum available, or set MAX_FD != -1 to use that value. 16 | MAX_FD="maximum" 17 | 18 | warn ( ) { 19 | echo "$*" 20 | } 21 | 22 | die ( ) { 23 | echo 24 | echo "$*" 25 | echo 26 | exit 1 27 | } 28 | 29 | # OS specific support (must be 'true' or 'false'). 30 | cygwin=false 31 | msys=false 32 | darwin=false 33 | case "`uname`" in 34 | CYGWIN* ) 35 | cygwin=true 36 | ;; 37 | Darwin* ) 38 | darwin=true 39 | ;; 40 | MINGW* ) 41 | msys=true 42 | ;; 43 | esac 44 | 45 | # Attempt to set APP_HOME 46 | # Resolve links: $0 may be a link 47 | PRG="$0" 48 | # Need this for relative symlinks. 49 | while [ -h "$PRG" ] ; do 50 | ls=`ls -ld "$PRG"` 51 | link=`expr "$ls" : '.*-> \(.*\)$'` 52 | if expr "$link" : '/.*' > /dev/null; then 53 | PRG="$link" 54 | else 55 | PRG=`dirname "$PRG"`"/$link" 56 | fi 57 | done 58 | SAVED="`pwd`" 59 | cd "`dirname \"$PRG\"`/" >/dev/null 60 | APP_HOME="`pwd -P`" 61 | cd "$SAVED" >/dev/null 62 | 63 | CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar 64 | 65 | # Determine the Java command to use to start the JVM. 66 | if [ -n "$JAVA_HOME" ] ; then 67 | if [ -x "$JAVA_HOME/jre/sh/java" ] ; then 68 | # IBM's JDK on AIX uses strange locations for the executables 69 | JAVACMD="$JAVA_HOME/jre/sh/java" 70 | else 71 | JAVACMD="$JAVA_HOME/bin/java" 72 | fi 73 | if [ ! -x "$JAVACMD" ] ; then 74 | die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME 75 | 76 | Please set the JAVA_HOME variable in your environment to match the 77 | location of your Java installation." 78 | fi 79 | else 80 | JAVACMD="java" 81 | which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 82 | 83 | Please set the JAVA_HOME variable in your environment to match the 84 | location of your Java installation." 85 | fi 86 | 87 | # Increase the maximum file descriptors if we can. 88 | if [ "$cygwin" = "false" -a "$darwin" = "false" ] ; then 89 | MAX_FD_LIMIT=`ulimit -H -n` 90 | if [ $? -eq 0 ] ; then 91 | if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then 92 | MAX_FD="$MAX_FD_LIMIT" 93 | fi 94 | ulimit -n $MAX_FD 95 | if [ $? -ne 0 ] ; then 96 | warn "Could not set maximum file descriptor limit: $MAX_FD" 97 | fi 98 | else 99 | warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT" 100 | fi 101 | fi 102 | 103 | # For Darwin, add options to specify how the application appears in the dock 104 | if $darwin; then 105 | GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\"" 106 | fi 107 | 108 | # For Cygwin, switch paths to Windows format before running java 109 | if $cygwin ; then 110 | APP_HOME=`cygpath --path --mixed "$APP_HOME"` 111 | CLASSPATH=`cygpath --path --mixed "$CLASSPATH"` 112 | JAVACMD=`cygpath --unix "$JAVACMD"` 113 | 114 | # We build the pattern for arguments to be converted via cygpath 115 | ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null` 116 | SEP="" 117 | for dir in $ROOTDIRSRAW ; do 118 | ROOTDIRS="$ROOTDIRS$SEP$dir" 119 | SEP="|" 120 | done 121 | OURCYGPATTERN="(^($ROOTDIRS))" 122 | # Add a user-defined pattern to the cygpath arguments 123 | if [ "$GRADLE_CYGPATTERN" != "" ] ; then 124 | OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)" 125 | fi 126 | # Now convert the arguments - kludge to limit ourselves to /bin/sh 127 | i=0 128 | for arg in "$@" ; do 129 | CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -` 130 | CHECK2=`echo "$arg"|egrep -c "^-"` ### Determine if an option 131 | 132 | if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then ### Added a condition 133 | eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"` 134 | else 135 | eval `echo args$i`="\"$arg\"" 136 | fi 137 | i=$((i+1)) 138 | done 139 | case $i in 140 | (0) set -- ;; 141 | (1) set -- "$args0" ;; 142 | (2) set -- "$args0" "$args1" ;; 143 | (3) set -- "$args0" "$args1" "$args2" ;; 144 | (4) set -- "$args0" "$args1" "$args2" "$args3" ;; 145 | (5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;; 146 | (6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;; 147 | (7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;; 148 | (8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;; 149 | (9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;; 150 | esac 151 | fi 152 | 153 | # Split up the JVM_OPTS And GRADLE_OPTS values into an array, following the shell quoting and substitution rules 154 | function splitJvmOpts() { 155 | JVM_OPTS=("$@") 156 | } 157 | eval splitJvmOpts $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS 158 | JVM_OPTS[${#JVM_OPTS[*]}]="-Dorg.gradle.appname=$APP_BASE_NAME" 159 | 160 | exec "$JAVACMD" "${JVM_OPTS[@]}" -classpath "$CLASSPATH" org.gradle.wrapper.GradleWrapperMain "$@" 161 | -------------------------------------------------------------------------------- /app/src/main/java/com/example/android/quakereport/EarthquakeAdapter.java: -------------------------------------------------------------------------------- 1 | package com.example.android.quakereport; 2 | 3 | import android.content.Context; 4 | import android.graphics.drawable.GradientDrawable; 5 | import android.support.annotation.NonNull; 6 | import android.support.annotation.Nullable; 7 | import android.support.v4.content.ContextCompat; 8 | import android.view.LayoutInflater; 9 | import android.view.View; 10 | import android.view.ViewGroup; 11 | import android.widget.ArrayAdapter; 12 | import android.widget.TextView; 13 | 14 | import java.text.DecimalFormat; 15 | import java.text.SimpleDateFormat; 16 | import java.util.Date; 17 | import java.util.List; 18 | 19 | /** 20 | * Created by bots on 2/10/18. 21 | */ 22 | 23 | public class EarthquakeAdapter extends ArrayAdapter { 24 | 25 | private static final String LOCATION_SEPERATOR = "of "; 26 | 27 | public EarthquakeAdapter(Context context, List earthquakes) { 28 | super(context, 0, earthquakes); 29 | } 30 | 31 | @NonNull 32 | @Override 33 | public View getView(int position, @Nullable View convertView, @NonNull ViewGroup parent) { 34 | 35 | View listItemView = convertView; 36 | 37 | if (listItemView == null) { 38 | 39 | listItemView = LayoutInflater.from(getContext()).inflate( 40 | R.layout.earthquake_list_item, parent, false); 41 | } 42 | 43 | //get current earthquake object at current position 44 | Earthquake currentEarthquake = getItem(position); 45 | 46 | TextView magnitudeView = (TextView) listItemView.findViewById(R.id.magnitude); 47 | magnitudeView.setText(formatMagnitude(currentEarthquake.getMagnitude())); 48 | 49 | GradientDrawable magnitudeCircle = (GradientDrawable) magnitudeView.getBackground(); 50 | 51 | int magnitudeColor = getMagnitudeColor(currentEarthquake.getMagnitude()); 52 | 53 | magnitudeCircle.setColor(magnitudeColor); 54 | 55 | //get the original Location of the event 56 | String originalLocation = currentEarthquake.getLocation(); 57 | 58 | String primaryLocation; 59 | String locationOffset; 60 | 61 | if(originalLocation.contains(LOCATION_SEPERATOR)) { 62 | String[] parts = originalLocation.split(LOCATION_SEPERATOR); 63 | locationOffset = parts[0] + LOCATION_SEPERATOR; 64 | primaryLocation = parts[1]; 65 | } else { 66 | locationOffset = getContext().getString(R.string.near_the); 67 | primaryLocation = originalLocation; 68 | } 69 | 70 | TextView primaryLocationView = (TextView) listItemView.findViewById(R.id.primary_location); 71 | primaryLocationView.setText(primaryLocation); 72 | 73 | TextView locationOffsetView = (TextView) listItemView.findViewById(R.id.location_offset); 74 | locationOffsetView.setText(locationOffset); 75 | 76 | 77 | //create a date object using timeInMilliseconds long 78 | Date dateObject = new Date(currentEarthquake.getTimeInMilliseconds()); 79 | 80 | //get the textview with id date 81 | TextView dateView = (TextView) listItemView.findViewById(R.id.date); 82 | 83 | // Format the date string (i.e. "Mar 3, 1984") 84 | String formattedDate = formatDate(dateObject); 85 | 86 | //display the date in the date textview 87 | dateView.setText(formattedDate); 88 | 89 | //get the textview with id time 90 | TextView timeView = (TextView) listItemView.findViewById(R.id.time); 91 | 92 | // Format the time String (i.e. "3:00 p") 93 | String formattedTime = formateTime(dateObject); 94 | 95 | //display the time in the time textview 96 | timeView.setText(formattedTime); 97 | 98 | return listItemView; 99 | 100 | } 101 | 102 | private String formatDate(Date dateObject) { 103 | SimpleDateFormat dateFormat = new SimpleDateFormat("LLL dd, yyyy"); 104 | return dateFormat.format(dateObject); 105 | } 106 | 107 | private String formateTime(Date dateObject) { 108 | SimpleDateFormat dateFormat = new SimpleDateFormat("h:mm a"); 109 | return dateFormat.format(dateObject); 110 | } 111 | 112 | private String formatMagnitude(double magnitude) { 113 | DecimalFormat formatter = new DecimalFormat("0.0"); 114 | return formatter.format(magnitude); 115 | } 116 | 117 | private int getMagnitudeColor(double magnitude) { 118 | int magnitudeColorResourceId; 119 | int magnitudeFloor = (int) Math.floor(magnitude); 120 | switch (magnitudeFloor) { 121 | case 0: 122 | case 1: 123 | magnitudeColorResourceId = R.color.magnitude1; 124 | break; 125 | case 2: 126 | magnitudeColorResourceId = R.color.magnitude2; 127 | break; 128 | case 3: 129 | magnitudeColorResourceId = R.color.magnitude3; 130 | break; 131 | case 4: 132 | magnitudeColorResourceId = R.color.magnitude4; 133 | break; 134 | case 5: 135 | magnitudeColorResourceId = R.color.magnitude5; 136 | break; 137 | case 6: 138 | magnitudeColorResourceId = R.color.magnitude6; 139 | break; 140 | case 7: 141 | magnitudeColorResourceId = R.color.magnitude7; 142 | break; 143 | case 8: 144 | magnitudeColorResourceId = R.color.magnitude8; 145 | break; 146 | case 9: 147 | magnitudeColorResourceId = R.color.magnitude9; 148 | break; 149 | default: 150 | magnitudeColorResourceId = R.color.magnitude10plus; 151 | break; 152 | } 153 | return ContextCompat.getColor(getContext(), magnitudeColorResourceId); 154 | } 155 | } 156 | 157 | 158 | 159 | 160 | 161 | 162 | 163 | 164 | 165 | 166 | 167 | 168 | -------------------------------------------------------------------------------- /app/src/main/java/com/example/android/quakereport/QueryUtils.java: -------------------------------------------------------------------------------- 1 | package com.example.android.quakereport; 2 | 3 | /** 4 | * Created by bots on 2/10/18. 5 | */ 6 | 7 | import android.text.TextUtils; 8 | import android.util.Log; 9 | 10 | import org.json.JSONArray; 11 | import org.json.JSONException; 12 | import org.json.JSONObject; 13 | 14 | import java.io.BufferedReader; 15 | import java.io.IOException; 16 | import java.io.InputStream; 17 | import java.io.InputStreamReader; 18 | import java.net.HttpURLConnection; 19 | import java.net.MalformedURLException; 20 | import java.net.URL; 21 | import java.nio.charset.Charset; 22 | import java.util.ArrayList; 23 | import java.util.List; 24 | 25 | import static com.example.android.quakereport.EarthquakeActivity.LOG_TAG; 26 | 27 | /** 28 | * Helper methods related to requesting and receiving earthquake data from USGS. 29 | */ 30 | public final class QueryUtils { 31 | 32 | /** 33 | * Create a private constructor because no one should ever create a {@link QueryUtils} object. 34 | * This class is only meant to hold static variables and methods, which can be accessed 35 | * directly from the class name QueryUtils (and an object instance of QueryUtils is not needed). 36 | */ 37 | private QueryUtils() { 38 | } 39 | 40 | /** 41 | * Return a list of {@link Earthquake} objects that has been built up from 42 | * parsing a JSON response. 43 | */ 44 | private static List extractFeatureFromJson(String earthquakeJson) { 45 | 46 | //if the json string is empty or null then return early 47 | if (TextUtils.isEmpty(earthquakeJson)) { 48 | return null; 49 | } 50 | 51 | // Create an empty ArrayList that we can start adding earthquakes to 52 | List earthquakes = new ArrayList<>(); 53 | 54 | // Try to parse the JSON response string. If there's a problem with the way the JSON 55 | // is formatted, a JSONException exception object will be thrown. 56 | // Catch the exception so the app doesn't crash, and print the error message to the logs. 57 | try{ 58 | 59 | // Create a JSONObject from the JSON response string 60 | JSONObject baseJsonResponse = new JSONObject(earthquakeJson); 61 | 62 | // Extract the JSONArray associated with the key called "features", 63 | // which represents a list of features (or earthquakes). 64 | JSONArray earthquakeArray = baseJsonResponse.getJSONArray("features"); 65 | 66 | // For each earthquake in the earthquakeArray, create an {@link Earthquake} object 67 | for (int i = 0; i < earthquakeArray.length(); i++) { 68 | 69 | // Get a single earthquake at position i within the list of earthquakes 70 | JSONObject currentEarthquake = earthquakeArray.getJSONObject(i); 71 | 72 | // For a given earthquake, extract the JSONObject associated with the 73 | // key called "properties", which represents a list of all properties 74 | // for that earthquake. 75 | JSONObject properties = currentEarthquake.getJSONObject("properties"); 76 | 77 | // Extract the value for the key called "mag" 78 | double magnitude = properties.getDouble("mag"); 79 | 80 | // Extract the value for the key called "place" 81 | String location = properties.getString("place"); 82 | 83 | // Extract the value for the key called "time" 84 | long time = properties.getLong("time"); 85 | 86 | // Extract the value for the key called "url" 87 | String url = properties.getString("url"); 88 | 89 | // Create a new {@link Earthquake} object with the magnitude, location, time, 90 | // and url from the JSON response. 91 | Earthquake earthquake = new Earthquake(magnitude, location, time, url); 92 | 93 | // Add the new {@link Earthquake} to the list of earthquakes. 94 | earthquakes.add(earthquake); 95 | } 96 | } catch (JSONException e){ 97 | 98 | // If an error is thrown when executing any of the above statements in the "try" block, 99 | // catch the exception here, so the app doesn't crash. Print a log message 100 | // with the message from the exception. 101 | Log.e("QueryUtils", "Problem parsing the earthquake JSON results", e); 102 | } 103 | // Return the list of earthquakes 104 | return earthquakes; 105 | } 106 | 107 | /** 108 | * Returns new URL object from the given string URL. 109 | */ 110 | private static URL createUrl(String stringUrl) { 111 | URL url = null; 112 | try { 113 | url = new URL(stringUrl); 114 | } catch (MalformedURLException e) { 115 | Log.e(LOG_TAG, "Problem building the URL", e); 116 | } 117 | return url; 118 | } 119 | 120 | /** 121 | * Returns new URL object from the given string URL. 122 | */ 123 | private static String makeHttpRequest(URL url) throws IOException { 124 | String jsonResponse = ""; 125 | 126 | if (url == null) { 127 | return jsonResponse; 128 | } 129 | 130 | HttpURLConnection urlConnection = null; 131 | InputStream inputStream = null; 132 | 133 | try { 134 | urlConnection = (HttpURLConnection) url.openConnection(); 135 | urlConnection.setReadTimeout(10000 /* milliseconds */); 136 | urlConnection.setConnectTimeout(15000 /* milliseconds */); 137 | urlConnection.setRequestMethod("GET"); 138 | urlConnection.connect(); 139 | 140 | if (urlConnection.getResponseCode() == 200) { 141 | inputStream = urlConnection.getInputStream(); 142 | jsonResponse = readFromStream(inputStream); 143 | } else { 144 | Log.e(LOG_TAG, "ERROR Response Code" + urlConnection.getResponseCode()); 145 | } 146 | } catch (IOException e) { 147 | Log.e(LOG_TAG, "Problem retrieving the earthquake JSON results.", e); 148 | } finally { 149 | if (urlConnection == null) { 150 | urlConnection.disconnect(); 151 | } 152 | if (inputStream != null) { 153 | // Closing the input stream could throw an IOException, which is why 154 | // the makeHttpRequest(URL url) method signature specifies than an IOException 155 | // could be thrown. 156 | inputStream.close(); 157 | } 158 | } 159 | return jsonResponse; 160 | } 161 | 162 | /** 163 | * Convert the {@link InputStream} into a String which contains the 164 | * whole JSON response from the server. 165 | */ 166 | private static String readFromStream(InputStream inputStream) throws IOException { 167 | StringBuilder output = new StringBuilder(); 168 | if (inputStream != null) { 169 | InputStreamReader inputStreamReader = new InputStreamReader(inputStream, Charset.forName("UTF-8")); 170 | BufferedReader reader = new BufferedReader(inputStreamReader); 171 | String line = reader.readLine(); 172 | while (line != null) { 173 | output.append(line); 174 | line = reader.readLine(); 175 | } 176 | } 177 | return output.toString(); 178 | } 179 | 180 | /** 181 | * Query the USGS dataset and return a list of {@link Earthquake} objects. 182 | */ 183 | public static List fetchEarthquakeData(String requestUrl) { 184 | 185 | // Create URL object 186 | URL url = createUrl(requestUrl); 187 | 188 | // Perform HTTP request to the URL and receive a JSON response back 189 | String jsonResponse = null; 190 | try { 191 | jsonResponse = makeHttpRequest(url); 192 | } catch (IOException e) { 193 | Log.e(LOG_TAG, "Problem making the http request", e); 194 | } 195 | 196 | // Extract relevant fields from the JSON response and create a list of {@link Earthquake}s 197 | List earthquakes = extractFeatureFromJson(jsonResponse); 198 | 199 | // Return the list of {@link Earthquake}s 200 | return earthquakes; 201 | } 202 | } 203 | 204 | 205 | 206 | 207 | 208 | 209 | 210 | 211 | 212 | 213 | 214 | 215 | 216 | 217 | 218 | 219 | 220 | 221 | 222 | 223 | 224 | 225 | 226 | 227 | 228 | 229 | 230 | 231 | -------------------------------------------------------------------------------- /app/src/main/java/com/example/android/quakereport/EarthquakeActivity.java: -------------------------------------------------------------------------------- 1 | /* 2 | * Copyright (C) 2016 The Android Open Source Project 3 | * 4 | * Licensed under the Apache License, Version 2.0 (the "License"); 5 | * you may not use this file except in compliance with the License. 6 | * You may obtain a copy of the License at 7 | * 8 | * http://www.apache.org/licenses/LICENSE-2.0 9 | * 10 | * Unless required by applicable law or agreed to in writing, software 11 | * distributed under the License is distributed on an "AS IS" BASIS, 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 | * See the License for the specific language governing permissions and 14 | * limitations under the License. 15 | */ 16 | package com.example.android.quakereport; 17 | 18 | import android.app.LoaderManager; 19 | import android.content.Context; 20 | import android.content.Intent; 21 | import android.content.Loader; 22 | import android.content.SharedPreferences; 23 | import android.net.ConnectivityManager; 24 | import android.net.NetworkInfo; 25 | import android.net.Uri; 26 | import android.os.Bundle; 27 | import android.preference.PreferenceFragment; 28 | import android.preference.PreferenceManager; 29 | import android.support.v7.app.AppCompatActivity; 30 | import android.view.Menu; 31 | import android.view.MenuItem; 32 | import android.view.View; 33 | import android.widget.AdapterView; 34 | import android.widget.ListView; 35 | import android.widget.TextView; 36 | 37 | import java.util.ArrayList; 38 | import java.util.List; 39 | 40 | public class EarthquakeActivity extends AppCompatActivity implements LoaderManager.LoaderCallbacks>{ 41 | 42 | public static final String LOG_TAG = EarthquakeActivity.class.getName(); 43 | 44 | /** TextView that is displayed when the list is empty */ 45 | private TextView mEmptyStateTextView; 46 | 47 | /** 48 | * Constant value for the earthquake loader ID. We can choose any integer. 49 | * This really only comes into play if you're using multiple loaders. 50 | */ 51 | private static final int EARTHQUAKE_LOADER_ID = 1; 52 | 53 | /** URL for earthquake data from the USGS dataset */ 54 | private static final String USGS_REQUEST_URL = "https://earthquake.usgs.gov/fdsnws/event/1/query"; 55 | 56 | /** Adapter for the list of earthquakes */ 57 | private EarthquakeAdapter mAdapter; 58 | 59 | @Override 60 | protected void onCreate(Bundle savedInstanceState) { 61 | super.onCreate(savedInstanceState); 62 | setContentView(R.layout.earthquake_activity); 63 | 64 | // Find a reference to the {@link ListView} in the layout 65 | ListView earthquakeListView = (ListView) findViewById(R.id.list); 66 | 67 | mEmptyStateTextView = (TextView) findViewById(R.id.empty_view); 68 | earthquakeListView.setEmptyView(mEmptyStateTextView); 69 | 70 | // Create a new adapter that takes an empty list of earthquakes as input 71 | mAdapter = new EarthquakeAdapter(this, new ArrayList()); 72 | 73 | // Set the adapter on the {@link ListView} 74 | // so the list can be populated in the user interface 75 | earthquakeListView.setAdapter(mAdapter); 76 | 77 | // Set an item click listener on the ListView, which sends an intent to a web browser 78 | // to open a website with more information about the selected earthquake. 79 | earthquakeListView.setOnItemClickListener(new AdapterView.OnItemClickListener() { 80 | @Override 81 | public void onItemClick(AdapterView adapterView, View view, int i, long l) { 82 | // Find the current earthquake that was clicked on 83 | Earthquake currentEarthquake = mAdapter.getItem(i); 84 | 85 | // Convert the String URL into a URI object (to pass into the Intent constructor) 86 | Uri earthquakeUri = Uri.parse(currentEarthquake.getUrl()); 87 | 88 | // Create a new intent to view the earthquake URI 89 | Intent websiteIntent = new Intent(Intent.ACTION_VIEW, earthquakeUri); 90 | 91 | // Send the intent to launch a new activity 92 | startActivity(websiteIntent); 93 | } 94 | }); 95 | 96 | // Get a reference to the ConnectivityManager to check state of network connectivity 97 | ConnectivityManager connMgr = (ConnectivityManager) getSystemService(Context.CONNECTIVITY_SERVICE); 98 | 99 | // Get details on the currently active default data network 100 | NetworkInfo networkInfo = connMgr.getActiveNetworkInfo(); 101 | 102 | // If there is a network connection, fetch data 103 | if (networkInfo != null && networkInfo.isConnected()) { 104 | // Get a reference to the LoaderManager, in order to interact with loaders. 105 | LoaderManager loaderManager = getLoaderManager(); 106 | 107 | // Initialize the loader. Pass in the int ID constant defined above and pass in null for 108 | // the bundle. Pass in this activity for the LoaderCallbacks parameter (which is valid 109 | // because this activity implements the LoaderCallbacks interface). 110 | loaderManager.initLoader(EARTHQUAKE_LOADER_ID, null, this); 111 | } else { 112 | // Otherwise, display error 113 | // First, hide loading indicator so error message will be visible 114 | View loadingIndicator = (View) findViewById(R.id.loading_indicator); 115 | loadingIndicator.setVisibility(View.GONE); 116 | 117 | // Update empty state with no connection error message 118 | mEmptyStateTextView.setText(R.string.no_internet_connection); 119 | } 120 | 121 | } 122 | 123 | @Override 124 | public Loader> onCreateLoader(int i, Bundle bundle) { 125 | 126 | // Create a new loader for the given URL 127 | SharedPreferences sharedPrefs = PreferenceManager.getDefaultSharedPreferences(this); 128 | 129 | // getString retrieves a String value from the preferences. The second parameter is the default value for this preference. 130 | String minMagnitude = sharedPrefs.getString( 131 | getString(R.string.settings_min_magnitude_key), 132 | getString(R.string.settings_min_magnitude_default)); 133 | 134 | // parse breaks apart the URI string that's passed into its parameter 135 | Uri baseUri = Uri.parse(USGS_REQUEST_URL); 136 | 137 | // buildUpon prepares the baseUri that we just parsed so we can add query parameters to it 138 | Uri.Builder uriBuilder = baseUri.buildUpon(); 139 | 140 | // Append query parameter and its value. For example, the `format=geojson` 141 | uriBuilder.appendQueryParameter("format", "geojson"); 142 | uriBuilder.appendQueryParameter("limit", "30"); 143 | uriBuilder.appendQueryParameter("minmag", minMagnitude); 144 | uriBuilder.appendQueryParameter("orderby", "time"); 145 | 146 | // Return the completed uri `http://earthquake.usgs.gov/fdsnws/event/1/query?format=geojson&limit=10&minmag=minMagnitude&orderby=time 147 | return new EarthquakeLoader(this, uriBuilder.toString()); 148 | } 149 | 150 | @Override 151 | public void onLoadFinished(Loader> loader, List earthquakes) { 152 | // Hide loading indicator because the data has been loaded 153 | View loadingIndicator = (View) findViewById(R.id.loading_indicator); 154 | loadingIndicator.setVisibility(View.GONE); 155 | 156 | // Set empty state text to display "No earthquakes found." 157 | mEmptyStateTextView.setText(R.string.no_earthquakes); 158 | 159 | // Clear the adapter of previous earthquake data 160 | mAdapter.clear(); 161 | 162 | // If there is a valid list of {@link Earthquake}s, then add them to the adapter's 163 | // data set. This will trigger the ListView to update. 164 | if (earthquakes != null && !earthquakes.isEmpty()) { 165 | mAdapter.addAll(earthquakes); 166 | } 167 | } 168 | 169 | @Override 170 | public void onLoaderReset(Loader> loader) { 171 | // Loader reset, so we can clear out our existing data. 172 | mAdapter.clear(); 173 | } 174 | 175 | @Override 176 | public boolean onCreateOptionsMenu(Menu menu) { 177 | getMenuInflater().inflate(R.menu.main, menu); 178 | return true; 179 | } 180 | 181 | @Override 182 | public boolean onOptionsItemSelected(MenuItem item) { 183 | int id = item.getItemId(); 184 | if (id == R.id.action_settings) { 185 | Intent settingsIntent = new Intent(this, SettingsActivity.class); 186 | startActivity(settingsIntent); 187 | return true; 188 | } 189 | return super.onOptionsItemSelected(item); 190 | } 191 | } 192 | 193 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | All image and audio files (including *.png, *.jpg, *.svg, *.mp3, *.wav 2 | and *.ogg) are licensed under the CC-BY-NC license. All other files are 3 | licensed under the Apache 2 license. 4 | 5 | ======================================================================= 6 | 7 | Apache License 8 | -------------- 9 | 10 | Version 2.0, January 2004 11 | http://www.apache.org/licenses/ 12 | 13 | TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 14 | 15 | 1. Definitions. 16 | 17 | "License" shall mean the terms and conditions for use, reproduction, 18 | and distribution as defined by Sections 1 through 9 of this document. 19 | 20 | "Licensor" shall mean the copyright owner or entity authorized by 21 | the copyright owner that is granting the License. 22 | 23 | "Legal Entity" shall mean the union of the acting entity and all 24 | other entities that control, are controlled by, or are under common 25 | control with that entity. For the purposes of this definition, 26 | "control" means (i) the power, direct or indirect, to cause the 27 | direction or management of such entity, whether by contract or 28 | otherwise, or (ii) ownership of fifty percent (50%) or more of the 29 | outstanding shares, or (iii) beneficial ownership of such entity. 30 | 31 | "You" (or "Your") shall mean an individual or Legal Entity 32 | exercising permissions granted by this License. 33 | 34 | "Source" form shall mean the preferred form for making modifications, 35 | including but not limited to software source code, documentation 36 | source, and configuration files. 37 | 38 | "Object" form shall mean any form resulting from mechanical 39 | transformation or translation of a Source form, including but 40 | not limited to compiled object code, generated documentation, 41 | and conversions to other media types. 42 | 43 | "Work" shall mean the work of authorship, whether in Source or 44 | Object form, made available under the License, as indicated by a 45 | copyright notice that is included in or attached to the work 46 | (an example is provided in the Appendix below). 47 | 48 | "Derivative Works" shall mean any work, whether in Source or Object 49 | form, that is based on (or derived from) the Work and for which the 50 | editorial revisions, annotations, elaborations, or other modifications 51 | represent, as a whole, an original work of authorship. For the purposes 52 | of this License, Derivative Works shall not include works that remain 53 | separable from, or merely link (or bind by name) to the interfaces of, 54 | the Work and Derivative Works thereof. 55 | 56 | "Contribution" shall mean any work of authorship, including 57 | the original version of the Work and any modifications or additions 58 | to that Work or Derivative Works thereof, that is intentionally 59 | submitted to Licensor for inclusion in the Work by the copyright owner 60 | or by an individual or Legal Entity authorized to submit on behalf of 61 | the copyright owner. For the purposes of this definition, "submitted" 62 | means any form of electronic, verbal, or written communication sent 63 | to the Licensor or its representatives, including but not limited to 64 | communication on electronic mailing lists, source code control systems, 65 | and issue tracking systems that are managed by, or on behalf of, the 66 | Licensor for the purpose of discussing and improving the Work, but 67 | excluding communication that is conspicuously marked or otherwise 68 | designated in writing by the copyright owner as "Not a Contribution." 69 | 70 | "Contributor" shall mean Licensor and any individual or Legal Entity 71 | on behalf of whom a Contribution has been received by Licensor and 72 | subsequently incorporated within the Work. 73 | 74 | 2. Grant of Copyright License. Subject to the terms and conditions of 75 | this License, each Contributor hereby grants to You a perpetual, 76 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable 77 | copyright license to reproduce, prepare Derivative Works of, 78 | publicly display, publicly perform, sublicense, and distribute the 79 | Work and such Derivative Works in Source or Object form. 80 | 81 | 3. Grant of Patent License. Subject to the terms and conditions of 82 | this License, each Contributor hereby grants to You a perpetual, 83 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable 84 | (except as stated in this section) patent license to make, have made, 85 | use, offer to sell, sell, import, and otherwise transfer the Work, 86 | where such license applies only to those patent claims licensable 87 | by such Contributor that are necessarily infringed by their 88 | Contribution(s) alone or by combination of their Contribution(s) 89 | with the Work to which such Contribution(s) was submitted. If You 90 | institute patent litigation against any entity (including a 91 | cross-claim or counterclaim in a lawsuit) alleging that the Work 92 | or a Contribution incorporated within the Work constitutes direct 93 | or contributory patent infringement, then any patent licenses 94 | granted to You under this License for that Work shall terminate 95 | as of the date such litigation is filed. 96 | 97 | 4. Redistribution. You may reproduce and distribute copies of the 98 | Work or Derivative Works thereof in any medium, with or without 99 | modifications, and in Source or Object form, provided that You 100 | meet the following conditions: 101 | 102 | (a) You must give any other recipients of the Work or 103 | Derivative Works a copy of this License; and 104 | 105 | (b) You must cause any modified files to carry prominent notices 106 | stating that You changed the files; and 107 | 108 | (c) You must retain, in the Source form of any Derivative Works 109 | that You distribute, all copyright, patent, trademark, and 110 | attribution notices from the Source form of the Work, 111 | excluding those notices that do not pertain to any part of 112 | the Derivative Works; and 113 | 114 | (d) If the Work includes a "NOTICE" text file as part of its 115 | distribution, then any Derivative Works that You distribute must 116 | include a readable copy of the attribution notices contained 117 | within such NOTICE file, excluding those notices that do not 118 | pertain to any part of the Derivative Works, in at least one 119 | of the following places: within a NOTICE text file distributed 120 | as part of the Derivative Works; within the Source form or 121 | documentation, if provided along with the Derivative Works; or, 122 | within a display generated by the Derivative Works, if and 123 | wherever such third-party notices normally appear. The contents 124 | of the NOTICE file are for informational purposes only and 125 | do not modify the License. You may add Your own attribution 126 | notices within Derivative Works that You distribute, alongside 127 | or as an addendum to the NOTICE text from the Work, provided 128 | that such additional attribution notices cannot be construed 129 | as modifying the License. 130 | 131 | You may add Your own copyright statement to Your modifications and 132 | may provide additional or different license terms and conditions 133 | for use, reproduction, or distribution of Your modifications, or 134 | for any such Derivative Works as a whole, provided Your use, 135 | reproduction, and distribution of the Work otherwise complies with 136 | the conditions stated in this License. 137 | 138 | 5. Submission of Contributions. Unless You explicitly state otherwise, 139 | any Contribution intentionally submitted for inclusion in the Work 140 | by You to the Licensor shall be under the terms and conditions of 141 | this License, without any additional terms or conditions. 142 | Notwithstanding the above, nothing herein shall supersede or modify 143 | the terms of any separate license agreement you may have executed 144 | with Licensor regarding such Contributions. 145 | 146 | 6. Trademarks. This License does not grant permission to use the trade 147 | names, trademarks, service marks, or product names of the Licensor, 148 | except as required for reasonable and customary use in describing the 149 | origin of the Work and reproducing the content of the NOTICE file. 150 | 151 | 7. Disclaimer of Warranty. Unless required by applicable law or 152 | agreed to in writing, Licensor provides the Work (and each 153 | Contributor provides its Contributions) on an "AS IS" BASIS, 154 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or 155 | implied, including, without limitation, any warranties or conditions 156 | of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A 157 | PARTICULAR PURPOSE. You are solely responsible for determining the 158 | appropriateness of using or redistributing the Work and assume any 159 | risks associated with Your exercise of permissions under this License. 160 | 161 | 8. Limitation of Liability. In no event and under no legal theory, 162 | whether in tort (including negligence), contract, or otherwise, 163 | unless required by applicable law (such as deliberate and grossly 164 | negligent acts) or agreed to in writing, shall any Contributor be 165 | liable to You for damages, including any direct, indirect, special, 166 | incidental, or consequential damages of any character arising as a 167 | result of this License or out of the use or inability to use the 168 | Work (including but not limited to damages for loss of goodwill, 169 | work stoppage, computer failure or malfunction, or any and all 170 | other commercial damages or losses), even if such Contributor 171 | has been advised of the possibility of such damages. 172 | 173 | 9. Accepting Warranty or Additional Liability. While redistributing 174 | the Work or Derivative Works thereof, You may choose to offer, 175 | and charge a fee for, acceptance of support, warranty, indemnity, 176 | or other liability obligations and/or rights consistent with this 177 | License. However, in accepting such obligations, You may act only 178 | on Your own behalf and on Your sole responsibility, not on behalf 179 | of any other Contributor, and only if You agree to indemnify, 180 | defend, and hold each Contributor harmless for any liability 181 | incurred by, or claims asserted against, such Contributor by reason 182 | of your accepting any such warranty or additional liability. 183 | 184 | END OF TERMS AND CONDITIONS 185 | 186 | APPENDIX: How to apply the Apache License to your work. 187 | 188 | To apply the Apache License to your work, attach the following 189 | boilerplate notice, with the fields enclosed by brackets "{}" 190 | replaced with your own identifying information. (Don't include 191 | the brackets!) The text should be enclosed in the appropriate 192 | comment syntax for the file format. We also recommend that a 193 | file or class name and description of purpose be included on the 194 | same "printed page" as the copyright notice for easier 195 | identification within third-party archives. 196 | 197 | Copyright 2016 The Android Open Source Project 198 | 199 | Licensed under the Apache License, Version 2.0 (the "License"); 200 | you may not use this file except in compliance with the License. 201 | You may obtain a copy of the License at 202 | 203 | http://www.apache.org/licenses/LICENSE-2.0 204 | 205 | Unless required by applicable law or agreed to in writing, software 206 | distributed under the License is distributed on an "AS IS" BASIS, 207 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 208 | See the License for the specific language governing permissions and 209 | limitations under the License. 210 | 211 | All image and audio files (including *.png, *.jpg, *.svg, *.mp3, *.wav 212 | and *.ogg) are licensed under the CC-BY-NC license. All other files are 213 | licensed under the Apache 2 license. 214 | 215 | CC-BY-NC License 216 | ---------------- 217 | 218 | Attribution-NonCommercial-ShareAlike 4.0 International 219 | 220 | ======================================================================= 221 | 222 | Creative Commons Corporation ("Creative Commons") is not a law firm and 223 | does not provide legal services or legal advice. Distribution of 224 | Creative Commons public licenses does not create a lawyer-client or 225 | other relationship. Creative Commons makes its licenses and related 226 | information available on an "as-is" basis. Creative Commons gives no 227 | warranties regarding its licenses, any material licensed under their 228 | terms and conditions, or any related information. Creative Commons 229 | disclaims all liability for damages resulting from their use to the 230 | fullest extent possible. 231 | 232 | Using Creative Commons Public Licenses 233 | 234 | Creative Commons public licenses provide a standard set of terms and 235 | conditions that creators and other rights holders may use to share 236 | original works of authorship and other material subject to copyright 237 | and certain other rights specified in the public license below. The 238 | following considerations are for informational purposes only, are not 239 | exhaustive, and do not form part of our licenses. 240 | 241 | Considerations for licensors: Our public licenses are 242 | intended for use by those authorized to give the public 243 | permission to use material in ways otherwise restricted by 244 | copyright and certain other rights. Our licenses are 245 | irrevocable. Licensors should read and understand the terms 246 | and conditions of the license they choose before applying it. 247 | Licensors should also secure all rights necessary before 248 | applying our licenses so that the public can reuse the 249 | material as expected. Licensors should clearly mark any 250 | material not subject to the license. This includes other CC- 251 | licensed material, or material used under an exception or 252 | limitation to copyright. More considerations for licensors: 253 | wiki.creativecommons.org/Considerations_for_licensors 254 | 255 | Considerations for the public: By using one of our public 256 | licenses, a licensor grants the public permission to use the 257 | licensed material under specified terms and conditions. If 258 | the licensor's permission is not necessary for any reason--for 259 | example, because of any applicable exception or limitation to 260 | copyright--then that use is not regulated by the license. Our 261 | licenses grant only permissions under copyright and certain 262 | other rights that a licensor has authority to grant. Use of 263 | the licensed material may still be restricted for other 264 | reasons, including because others have copyright or other 265 | rights in the material. A licensor may make special requests, 266 | such as asking that all changes be marked or described. 267 | Although not required by our licenses, you are encouraged to 268 | respect those requests where reasonable. More_considerations 269 | for the public: 270 | wiki.creativecommons.org/Considerations_for_licensees 271 | 272 | ======================================================================= 273 | 274 | Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International 275 | Public License 276 | 277 | By exercising the Licensed Rights (defined below), You accept and agree 278 | to be bound by the terms and conditions of this Creative Commons 279 | Attribution-NonCommercial-ShareAlike 4.0 International Public License 280 | ("Public License"). To the extent this Public License may be 281 | interpreted as a contract, You are granted the Licensed Rights in 282 | consideration of Your acceptance of these terms and conditions, and the 283 | Licensor grants You such rights in consideration of benefits the 284 | Licensor receives from making the Licensed Material available under 285 | these terms and conditions. 286 | 287 | 288 | Section 1 -- Definitions. 289 | 290 | a. Adapted Material means material subject to Copyright and Similar 291 | Rights that is derived from or based upon the Licensed Material 292 | and in which the Licensed Material is translated, altered, 293 | arranged, transformed, or otherwise modified in a manner requiring 294 | permission under the Copyright and Similar Rights held by the 295 | Licensor. For purposes of this Public License, where the Licensed 296 | Material is a musical work, performance, or sound recording, 297 | Adapted Material is always produced where the Licensed Material is 298 | synched in timed relation with a moving image. 299 | 300 | b. Adapter's License means the license You apply to Your Copyright 301 | and Similar Rights in Your contributions to Adapted Material in 302 | accordance with the terms and conditions of this Public License. 303 | 304 | c. BY-NC-SA Compatible License means a license listed at 305 | creativecommons.org/compatiblelicenses, approved by Creative 306 | Commons as essentially the equivalent of this Public License. 307 | 308 | d. Copyright and Similar Rights means copyright and/or similar rights 309 | closely related to copyright including, without limitation, 310 | performance, broadcast, sound recording, and Sui Generis Database 311 | Rights, without regard to how the rights are labeled or 312 | categorized. For purposes of this Public License, the rights 313 | specified in Section 2(b)(1)-(2) are not Copyright and Similar 314 | Rights. 315 | 316 | e. Effective Technological Measures means those measures that, in the 317 | absence of proper authority, may not be circumvented under laws 318 | fulfilling obligations under Article 11 of the WIPO Copyright 319 | Treaty adopted on December 20, 1996, and/or similar international 320 | agreements. 321 | 322 | f. Exceptions and Limitations means fair use, fair dealing, and/or 323 | any other exception or limitation to Copyright and Similar Rights 324 | that applies to Your use of the Licensed Material. 325 | 326 | g. License Elements means the license attributes listed in the name 327 | of a Creative Commons Public License. The License Elements of this 328 | Public License are Attribution, NonCommercial, and ShareAlike. 329 | 330 | h. Licensed Material means the artistic or literary work, database, 331 | or other material to which the Licensor applied this Public 332 | License. 333 | 334 | i. Licensed Rights means the rights granted to You subject to the 335 | terms and conditions of this Public License, which are limited to 336 | all Copyright and Similar Rights that apply to Your use of the 337 | Licensed Material and that the Licensor has authority to license. 338 | 339 | j. Licensor means the individual(s) or entity(ies) granting rights 340 | under this Public License. 341 | 342 | k. NonCommercial means not primarily intended for or directed towards 343 | commercial advantage or monetary compensation. For purposes of 344 | this Public License, the exchange of the Licensed Material for 345 | other material subject to Copyright and Similar Rights by digital 346 | file-sharing or similar means is NonCommercial provided there is 347 | no payment of monetary compensation in connection with the 348 | exchange. 349 | 350 | l. Share means to provide material to the public by any means or 351 | process that requires permission under the Licensed Rights, such 352 | as reproduction, public display, public performance, distribution, 353 | dissemination, communication, or importation, and to make material 354 | available to the public including in ways that members of the 355 | public may access the material from a place and at a time 356 | individually chosen by them. 357 | 358 | m. Sui Generis Database Rights means rights other than copyright 359 | resulting from Directive 96/9/EC of the European Parliament and of 360 | the Council of 11 March 1996 on the legal protection of databases, 361 | as amended and/or succeeded, as well as other essentially 362 | equivalent rights anywhere in the world. 363 | 364 | n. You means the individual or entity exercising the Licensed Rights 365 | under this Public License. Your has a corresponding meaning. 366 | 367 | 368 | Section 2 -- Scope. 369 | 370 | a. License grant. 371 | 372 | 1. Subject to the terms and conditions of this Public License, 373 | the Licensor hereby grants You a worldwide, royalty-free, 374 | non-sublicensable, non-exclusive, irrevocable license to 375 | exercise the Licensed Rights in the Licensed Material to: 376 | 377 | a. reproduce and Share the Licensed Material, in whole or 378 | in part, for NonCommercial purposes only; and 379 | 380 | b. produce, reproduce, and Share Adapted Material for 381 | NonCommercial purposes only. 382 | 383 | 2. Exceptions and Limitations. For the avoidance of doubt, where 384 | Exceptions and Limitations apply to Your use, this Public 385 | License does not apply, and You do not need to comply with 386 | its terms and conditions. 387 | 388 | 3. Term. The term of this Public License is specified in Section 389 | 6(a). 390 | 391 | 4. Media and formats; technical modifications allowed. The 392 | Licensor authorizes You to exercise the Licensed Rights in 393 | all media and formats whether now known or hereafter created, 394 | and to make technical modifications necessary to do so. The 395 | Licensor waives and/or agrees not to assert any right or 396 | authority to forbid You from making technical modifications 397 | necessary to exercise the Licensed Rights, including 398 | technical modifications necessary to circumvent Effective 399 | Technological Measures. For purposes of this Public License, 400 | simply making modifications authorized by this Section 2(a) 401 | (4) never produces Adapted Material. 402 | 403 | 5. Downstream recipients. 404 | 405 | a. Offer from the Licensor -- Licensed Material. Every 406 | recipient of the Licensed Material automatically 407 | receives an offer from the Licensor to exercise the 408 | Licensed Rights under the terms and conditions of this 409 | Public License. 410 | 411 | b. Additional offer from the Licensor -- Adapted Material. 412 | Every recipient of Adapted Material from You 413 | automatically receives an offer from the Licensor to 414 | exercise the Licensed Rights in the Adapted Material 415 | under the conditions of the Adapter's License You apply. 416 | 417 | c. No downstream restrictions. You may not offer or impose 418 | any additional or different terms or conditions on, or 419 | apply any Effective Technological Measures to, the 420 | Licensed Material if doing so restricts exercise of the 421 | Licensed Rights by any recipient of the Licensed 422 | Material. 423 | 424 | 6. No endorsement. Nothing in this Public License constitutes or 425 | may be construed as permission to assert or imply that You 426 | are, or that Your use of the Licensed Material is, connected 427 | with, or sponsored, endorsed, or granted official status by, 428 | the Licensor or others designated to receive attribution as 429 | provided in Section 3(a)(1)(A)(i). 430 | 431 | b. Other rights. 432 | 433 | 1. Moral rights, such as the right of integrity, are not 434 | licensed under this Public License, nor are publicity, 435 | privacy, and/or other similar personality rights; however, to 436 | the extent possible, the Licensor waives and/or agrees not to 437 | assert any such rights held by the Licensor to the limited 438 | extent necessary to allow You to exercise the Licensed 439 | Rights, but not otherwise. 440 | 441 | 2. Patent and trademark rights are not licensed under this 442 | Public License. 443 | 444 | 3. To the extent possible, the Licensor waives any right to 445 | collect royalties from You for the exercise of the Licensed 446 | Rights, whether directly or through a collecting society 447 | under any voluntary or waivable statutory or compulsory 448 | licensing scheme. In all other cases the Licensor expressly 449 | reserves any right to collect such royalties, including when 450 | the Licensed Material is used other than for NonCommercial 451 | purposes. 452 | 453 | 454 | Section 3 -- License Conditions. 455 | 456 | Your exercise of the Licensed Rights is expressly made subject to the 457 | following conditions. 458 | 459 | a. Attribution. 460 | 461 | 1. If You Share the Licensed Material (including in modified 462 | form), You must: 463 | 464 | a. retain the following if it is supplied by the Licensor 465 | with the Licensed Material: 466 | 467 | i. identification of the creator(s) of the Licensed 468 | Material and any others designated to receive 469 | attribution, in any reasonable manner requested by 470 | the Licensor (including by pseudonym if 471 | designated); 472 | 473 | ii. a copyright notice; 474 | 475 | iii. a notice that refers to this Public License; 476 | 477 | iv. a notice that refers to the disclaimer of 478 | warranties; 479 | 480 | v. a URI or hyperlink to the Licensed Material to the 481 | extent reasonably practicable; 482 | 483 | b. indicate if You modified the Licensed Material and 484 | retain an indication of any previous modifications; and 485 | 486 | c. indicate the Licensed Material is licensed under this 487 | Public License, and include the text of, or the URI or 488 | hyperlink to, this Public License. 489 | 490 | 2. You may satisfy the conditions in Section 3(a)(1) in any 491 | reasonable manner based on the medium, means, and context in 492 | which You Share the Licensed Material. For example, it may be 493 | reasonable to satisfy the conditions by providing a URI or 494 | hyperlink to a resource that includes the required 495 | information. 496 | 3. If requested by the Licensor, You must remove any of the 497 | information required by Section 3(a)(1)(A) to the extent 498 | reasonably practicable. 499 | 500 | b. ShareAlike. 501 | 502 | In addition to the conditions in Section 3(a), if You Share 503 | Adapted Material You produce, the following conditions also apply. 504 | 505 | 1. The Adapter's License You apply must be a Creative Commons 506 | license with the same License Elements, this version or 507 | later, or a BY-NC-SA Compatible License. 508 | 509 | 2. You must include the text of, or the URI or hyperlink to, the 510 | Adapter's License You apply. You may satisfy this condition 511 | in any reasonable manner based on the medium, means, and 512 | context in which You Share Adapted Material. 513 | 514 | 3. You may not offer or impose any additional or different terms 515 | or conditions on, or apply any Effective Technological 516 | Measures to, Adapted Material that restrict exercise of the 517 | rights granted under the Adapter's License You apply. 518 | 519 | 520 | Section 4 -- Sui Generis Database Rights. 521 | 522 | Where the Licensed Rights include Sui Generis Database Rights that 523 | apply to Your use of the Licensed Material: 524 | 525 | a. for the avoidance of doubt, Section 2(a)(1) grants You the right 526 | to extract, reuse, reproduce, and Share all or a substantial 527 | portion of the contents of the database for NonCommercial purposes 528 | only; 529 | 530 | b. if You include all or a substantial portion of the database 531 | contents in a database in which You have Sui Generis Database 532 | Rights, then the database in which You have Sui Generis Database 533 | Rights (but not its individual contents) is Adapted Material, 534 | including for purposes of Section 3(b); and 535 | 536 | c. You must comply with the conditions in Section 3(a) if You Share 537 | all or a substantial portion of the contents of the database. 538 | 539 | For the avoidance of doubt, this Section 4 supplements and does not 540 | replace Your obligations under this Public License where the Licensed 541 | Rights include other Copyright and Similar Rights. 542 | 543 | 544 | Section 5 -- Disclaimer of Warranties and Limitation of Liability. 545 | 546 | a. UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE 547 | EXTENT POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS 548 | AND AS-AVAILABLE, AND MAKES NO REPRESENTATIONS OR WARRANTIES OF 549 | ANY KIND CONCERNING THE LICENSED MATERIAL, WHETHER EXPRESS, 550 | IMPLIED, STATUTORY, OR OTHER. THIS INCLUDES, WITHOUT LIMITATION, 551 | WARRANTIES OF TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR 552 | PURPOSE, NON-INFRINGEMENT, ABSENCE OF LATENT OR OTHER DEFECTS, 553 | ACCURACY, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR NOT 554 | KNOWN OR DISCOVERABLE. WHERE DISCLAIMERS OF WARRANTIES ARE NOT 555 | ALLOWED IN FULL OR IN PART, THIS DISCLAIMER MAY NOT APPLY TO YOU. 556 | 557 | b. TO THE EXTENT POSSIBLE, IN NO EVENT WILL THE LICENSOR BE LIABLE 558 | TO YOU ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION, 559 | NEGLIGENCE) OR OTHERWISE FOR ANY DIRECT, SPECIAL, INDIRECT, 560 | INCIDENTAL, CONSEQUENTIAL, PUNITIVE, EXEMPLARY, OR OTHER LOSSES, 561 | COSTS, EXPENSES, OR DAMAGES ARISING OUT OF THIS PUBLIC LICENSE OR 562 | USE OF THE LICENSED MATERIAL, EVEN IF THE LICENSOR HAS BEEN 563 | ADVISED OF THE POSSIBILITY OF SUCH LOSSES, COSTS, EXPENSES, OR 564 | DAMAGES. WHERE A LIMITATION OF LIABILITY IS NOT ALLOWED IN FULL OR 565 | IN PART, THIS LIMITATION MAY NOT APPLY TO YOU. 566 | 567 | c. The disclaimer of warranties and limitation of liability provided 568 | above shall be interpreted in a manner that, to the extent 569 | possible, most closely approximates an absolute disclaimer and 570 | waiver of all liability. 571 | 572 | 573 | Section 6 -- Term and Termination. 574 | 575 | a. This Public License applies for the term of the Copyright and 576 | Similar Rights licensed here. However, if You fail to comply with 577 | this Public License, then Your rights under this Public License 578 | terminate automatically. 579 | 580 | b. Where Your right to use the Licensed Material has terminated under 581 | Section 6(a), it reinstates: 582 | 583 | 1. automatically as of the date the violation is cured, provided 584 | it is cured within 30 days of Your discovery of the 585 | violation; or 586 | 587 | 2. upon express reinstatement by the Licensor. 588 | 589 | For the avoidance of doubt, this Section 6(b) does not affect any 590 | right the Licensor may have to seek remedies for Your violations 591 | of this Public License. 592 | 593 | c. For the avoidance of doubt, the Licensor may also offer the 594 | Licensed Material under separate terms or conditions or stop 595 | distributing the Licensed Material at any time; however, doing so 596 | will not terminate this Public License. 597 | 598 | d. Sections 1, 5, 6, 7, and 8 survive termination of this Public 599 | License. 600 | 601 | 602 | Section 7 -- Other Terms and Conditions. 603 | 604 | a. The Licensor shall not be bound by any additional or different 605 | terms or conditions communicated by You unless expressly agreed. 606 | 607 | b. Any arrangements, understandings, or agreements regarding the 608 | Licensed Material not stated herein are separate from and 609 | independent of the terms and conditions of this Public License. 610 | 611 | 612 | Section 8 -- Interpretation. 613 | 614 | a. For the avoidance of doubt, this Public License does not, and 615 | shall not be interpreted to, reduce, limit, restrict, or impose 616 | conditions on any use of the Licensed Material that could lawfully 617 | be made without permission under this Public License. 618 | 619 | b. To the extent possible, if any provision of this Public License is 620 | deemed unenforceable, it shall be automatically reformed to the 621 | minimum extent necessary to make it enforceable. If the provision 622 | cannot be reformed, it shall be severed from this Public License 623 | without affecting the enforceability of the remaining terms and 624 | conditions. 625 | 626 | c. No term or condition of this Public License will be waived and no 627 | failure to comply consented to unless expressly agreed to by the 628 | Licensor. 629 | 630 | d. Nothing in this Public License constitutes or may be interpreted 631 | as a limitation upon, or waiver of, any privileges and immunities 632 | that apply to the Licensor or You, including from the legal 633 | processes of any jurisdiction or authority. 634 | 635 | ======================================================================= 636 | 637 | Creative Commons is not a party to its public licenses. 638 | Notwithstanding, Creative Commons may elect to apply one of its public 639 | licenses to material it publishes and in those instances will be 640 | considered the "Licensor." Except for the limited purpose of indicating 641 | that material is shared under a Creative Commons public license or as 642 | otherwise permitted by the Creative Commons policies published at 643 | creativecommons.org/policies, Creative Commons does not authorize the 644 | use of the trademark "Creative Commons" or any other trademark or logo 645 | of Creative Commons without its prior written consent including, 646 | without limitation, in connection with any unauthorized modifications 647 | to any of its public licenses or any other arrangements, 648 | understandings, or agreements concerning use of licensed material. For 649 | the avoidance of doubt, this paragraph does not form part of the public 650 | licenses. 651 | 652 | Creative Commons may be contacted at creativecommons.org. --------------------------------------------------------------------------------