hms-core / hms-sitekit-demo

HMS Site Kit demo provides an example of intergrating HMS Core Site Android SDK. your app can provide users with convenient and secure access to diverse, place-related services.

HMS Site Kit for Android

English | 中文

Table of Contents

• Introduction
• Getting Started
• Supported Environments
• Support
• Result
• License

Introduction

With HUAWEI Site Kit, your app can provide users with convenient and secure access to diverse, place-related services.

HUAWEI Site Kit provides the following core capabilities you need to quickly build apps with which your users can explore the world around them:

• Place search: Returns a place list based on keywords entered by the user.
• Nearby place search: Searches for nearby places based on the current location of the user's device.
• Place details: Searches for details about a place.
• Search suggestion: Returns a list of place suggestions.
• Widget:A search component of the built-in place search suggestion feature.
• Autocomplete:Return an autocomplete place and a list of suggested places.

You also can use HMS Toolkit to quickly integrate the kit and run the demo project, as well as debug the app using a remote device for free. For details, please visit https://developer.huawei.com/consumer/en/doc/development/Tools-Guides/getting-started-0000001077381096

Getting Started

We provide an sample to demonstrate the use of Site SDK for Android.

This sample uses the Gradle build system.

First download the demo by cloning this repository or downloading an archived snapshot.

In Android Studio, use the "Open an existing Android Studio project", and select the directory of "site-sample".

You can use the "gradlew build" command to build the project directly.

You should create an app in AppGallery Connect, and obtain the file of agconnect-services.json and add to the project. You should also generate a signing certificate fingerprint and add the certificate file to the project, and add configuration to build.gradle. See the Configuring App Information in AppGallery Connect guide to configure app in AppGallery Connect. In addition, change the value of the apiKey variable ("your api key") of the getApiKey function in Utils.java or Utils.kt to the value of apiKey obtained from agconnect-services.json.

For more development guidance, please refer to the links below:

• Development Guide
• API References

Supported Environments

Android SDK Version >= 19 and JDK version >= 1.8 is recommended.

Support

If you have any questions or comments during use, welcome to make suggestions or exchange here: https://github.com/HMS-Core/hms-sitekit-demo/issues

Result

Question or issues

If you want to evaluate more about HMS Core, r/HMSCore on Reddit is for you to keep up with latest news about HMS Core, and to exchange insights with other developers.

If you have questions about how to use HMS samples, try the following options:

• Stack Overflow is the best place for any programming questions. Be sure to tag your question with huawei-mobile-services.
• Huawei Developer Forum HMS Core Module is great for general questions, or seeking recommendations and opinions.

If you run into a bug in our samples, please submit an issue to the Repository. Even better you can submit a Pull Request with a fix.

License

Apache License version 2.0

You can get a licensed copy at: https://github.com/HMS-Core/hms-sitekit-demo/blob/master/LICENSE