Get everything you need to use Cloud Services in your web applications.
Branch: develop
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


ThinkGeoCloudClient.js is an open-source JavaScript SDK for making request to ThinkGeo Cloud Service. It simplifies the process of the code of request.


Create a basic web application with CloudClient.js

In this walkthrough, you will learn how to create a basic web application with CloudClient.js. You should have some familiarity with HTML/CSS and JavaScript, but the source code is provided. Any operating system or text editor will work, but you will need an internet connection while you are working (Take GeoCoding Service as example).

Step 1: Create an API Key

CloudClient.js requires an API key for access to ThinkGeo Cloud services, it can be created following the guide of "Create a Client Key". For help, see the API Reference or Quick Start Guide.

Step 2: Create an index page

To get started making your application with Cloud Service, you need to use a text editor to update the HTML.

  1. Start your text editor with a blank document "index.html" and copy and paste the following HTML.
<!DOCTYPE html>
    <meta charset="utf-8">
  1. In the <head> tag, add a title, such as <title>My Cloud Service Sample</title>.

  2. In the <body> tag, add a DIV to show the response from Cloud Services.

After all the above, the HTML document should look as below:

<!DOCTYPE html>
    <meta charset="utf-8">
    <title>My Cloud Service Sample</title>
    <div id="response"></div>

Step 3: Add references JavaScript files

To get started using CloudClient.js, you need to link to the JS files in the '' section. Both NPM or CDN provides the minified version, which is a compressed file that improves performance.


Load from CDN in your project:

<!-- latest minified version of thinkgeocloudclient.js -->
<script src=""></script>
  • Install the package:
npm i thinkgeocloudclient-js
  • Include it to your page:
<!-- latest minified version of thinkgeocloudclient.js -->
<script src="path/to/dist/thinkgeocloudclient.js"></script>

Step 4: At the bottom of your page, add a JavaScript section to consume the services.

let reverseGeocodingClient = new tg.ReverseGeocodingClient('Your-Cloud-Service-Api-Key');

// Find the ThinkGeo office address by coordinate
reverseGeocodingClient.searchPlaceByPoint(33.128367, -96.809847, function (status, response) {

   if ( {
      let address =;

      document.getElementById('response').innerHTML = address;