An app that allows to explore landmarks by scanning landmark images
✈? Explore Landmarks ?✈
ExploreLandmarksAllFeatures.mp4
Screenshots
? Introduction
Explore Landmarks is a reference application for HMS Kits to phones running with the android based
HMS Service. Explore Landmark app is provides you to learn more information about the landmark
detected from an image given by you. It scans your image and recognizes landmark that exists in the
image. After that, the app gives you information about the landmark. And also it provides you to
view panoramic images and panoramic videos about the landmark. Additionally, the app provides an
image gallery that contains a lot of images related to the recognized landmark from the image given
by you. With all of these features, the app provides you to an authentication feature, too. With
this feature, you can share your saved credentials with other trusted apps or platforms. You can
retrieve saved credentials and delete them if you want.
? Download
? Features
?? Sharing & Managing Credentials
Thanks to Huawei Keyring Service you
can list, save, delete and share user credentials in this app. Keyring offers the Credentials
Management API for storing user credentials locally on Android phones and tablets and sharing them
between different apps and different platform versions of an app. For understanding how keyring is
used in this app you can look at Authentication Fragment and related classes with it.
AuthVideo.mp4
? Landmark Recognition
Thanks to Huawei Machine Learning you
can recognize landmarks into images by this app. You have an image related to a landmark and do you
forget the name of the landmark? Okay, no problem just take a photo of the image and learn the
landmark information. Are you on travel and do you want to learn more information about the landmark
of you visiting? Okay just take a picture of the landmark and learn the landmark information. Also,
you can learn the landmark information by choosing an image that contains a landmark from the
gallery.
Landmark.Recognition.mp4
? Landmark Detail – Information
You can see the recognized landmark information on this screen. And you can navigate to some screens
related to the landmark. You can see details of these landmarks in this repo: The Eiffel Tower, The
Sydney Opera House, The Burj Khalifa, The Kabah. When you try the repo please attention to that. Try
these landmarks if you want to learn detail about the landmarks.
? ? Panoramic Image and Video
Thanks to Huawei Panorama Kit
you can view panoramic images and panoramic videos of the landmarks in this app. There are 2
panoramic images each of The Eiffel Tower, The Sydney Opera House, The Burj Khalifa, The Kabah in
this repo.
PanoramicImage.mp4
There is 1 panoramic video each of The Eiffel Tower and The Burj Khalifa in this repo.
PanoramicVideo.mp4
? Image Gallery
Thanks to Huawei Search Kit you
can view more images of the recognized landmark in this app. No any landmark limitations such as
Panorama Screen or Detail Screen in this feature. You can view more images (with nice animations) of
any recognized landmark on this screen.
ImageGallery.mp4
? Tech Stack & Used Kits
Explore Landmarks app is designed with MVVM (Model-View-Viewmodel), Repository design patterns and
Kotlin is used for development.
Used Kits
✅ HUAWEI KEYRING SERVICE
✅ HUAWEI MACHINE LEARNING KIT
✅ HUAWEI PANORAMA KIT
✅ HUAWEI SEARCH KIT
✅ HUAWEI ANALYTICS KIT
✅ HUAWEI APP GALLERY CONNECT CRASH SERVICE
Tech Stack
✅ Hilt (DI)
✅ Architecture Components (DataBinding, ViewModel, LiveData)
✅ Coroutines
✅ Jetpack Navigation component
✅ Airbnb Lottie
✅ Facebook Shimmer
✅ KenBurnsView
✅ Glide
✅ Scrolling Pager Indicator
❓ Let’s Try the App – What You Will Need
- A computer that can run Android Studio ?.
- An android device with Hms Core installed and OS version Android 7 or higher (minSdk is API 24)
- Fork this repo by clicking top right and clone it to your computer.
- You need to AGConnect-Services.json file to run this project properly. Follow the below steps to
obtain it.- Create Huawei Developer Account if you haven’t got an account
- Go to the app-level build.gradle file and change the application id of the project. (You don’t need to change the package name in the whole repo.)
- Create a SignIn Certificate with key0 alias, ExploreLandmarks password and named as ExploreLandmarks.jks
. Actually this password and alias are not mandatory but if you want to sign with different
alias or password please don’t forget to change needed information in build.gradle (app:level)
to with new information. Replace this file with ExploreLandmarks.jks which already exist on the
app directory. - Generate SHA-256 Fingerprint via Keytool
or running the signingReport task (View => Tool Windows => Gradle => Tasks => Android =>
signingReport) - Login to Huawei Developer Console if you
didn’t log in. - Create a new app with the new applicationId in AppGallery and integrate the repo with it (
Creating an app, adding SHA-256 to AppGallery Connect, Downloading AgConnectServices.json file) - Before downloading agconnect-services.json choose a Data Processing Location on Project Settings
-> General Information (I recommended Germany because I use it and the search feature is worked
properly with it.). - Before downloading and moving agconnect-services.json file to the “app” folder,
please make enable necessary services
. For this project you have to set enable Auth Service, Account Kit, ML Kit, Search Kit, Keyring
Service, Analytics Kit.
- You need to client id and client secret to obtain an access token from Account Kit via OAuth-based
authentication. Get this information
under Project Settings => General Information => App information => OAuth 2.0 client ID section
and add them into app level build.gradle file. - You need to app id for Search Kit
. Take the “app_id” value from the agconnect-services.json file and set it to the AGC_APP_ID_VALUE
value in the application level build.gradle file. - You need to add the API key for using ML Kit on cloud services
Take the “api_key” value from the agconnect-services.json file and set it to the API_KEY_VALUE
value in the application level build.gradle file. - Solution of some issues you might be faced
- Error Code 907135000 : Please move agconnect-services.json file under to app directory.
- Error Code 6003 : Enable App Signing by choosing “Let AppGallery Connect create and manage app signature for me”
Sonarqube Report ✅ Passed ?
Licence
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.