Tencent Maps API
Apr 24,2026

GISBox is a one-stop 3D GIS data editing, conversion and publishing platform that supports editing in multiple GIS formats such as OSGB/GEOTIFF/RVT, converting to 3DTiles/Terrain and publishing.

Introduction

Tencent Maps API (Tencent Map Location Service Platform) is a location service interface provided by Tencent. Developers can call its capabilities for mapping, positioning, route planning, place search, etc., via multiple technical platforms such as JavaScript, Android, and iOS, enabling rapid integration of map functionality into applications or websites. The API supports free Key application with no call frequency limits and is widely used in industries such as mobility, logistics, and retail, offering high-precision positioning, real-time traffic conditions, reverse geocoding, and a wealth of other features. The platform also provides visualization tools and data services to support enterprise digital transformation.

File Structure

The file structure of Tencent Maps API varies by development platform (e.g., Web, Android, iOS), but the core design follows a modular approach. Specifics are as follows:

  • Web (JavaScript API): Mainly used by including the Tencent Maps JavaScript library file, with no need to download the full SDK. Developers simply add the official JS file link in HTML via a <script> tag and initialize the map object qq.maps.Map.
  • Android SDK: Provided as JAR or AAR packages, containing core modules for map rendering, positioning, navigation, etc.
  • iOS SDK: Integrated in the form of a Framework, primarily including QMapKit.framework and, starting from version 4.5.6, the required QMapFoundation.framework. Additionally, the resource bundle qmapkit.bundle must be added to the project to store static resources such as icons and configuration files. -ObjC must be added to "Other Linker Flags" during compilation to ensure correct loading of category methods.

General Structural Features: Regardless of platform, the Tencent Maps SDK adopts a layered architecture that separates responsibilities such as map rendering, data management, user interaction, and network requests, enhancing stability and maintainability. Developers can obtain detailed class inheritance relationships and interface descriptions from the official documentation.

Pros

  1. Deep Ecosystem Integration: Leveraging Tencent products such as WeChat and QQ, the API has natural advantages in mini-programs and social scenarios, making it especially suitable for projects needing to interact with the WeChat ecosystem.
  2. High Concurrency and Strong Stability: Supports millions of QPS per cluster, with an average API response time of less than 100ms, handling over 18 billion positioning requests daily, making it ideal for high-load business scenarios.
  3. Extensive Data Coverage: Offers over 80 million POI data points and coverage of more than 13 million kilometers of roads, supporting real-time traffic conditions in over 400 cities, with high data update frequency (over 200,000 POI updates daily).
  4. Mature Industry Solutions: Provides customized capabilities for verticals such as smart mobility, logistics, cultural tourism, and retail, including ride-hailing driver-passenger simultaneous display, batch route optimization, and scenic area heatmap navigation.
  5. Low Development Cost: Free Key application with no daily call limits, making it friendly for small and medium-sized enterprises and startup projects.

Cons

  1. Weaker Official Documentation Experience: Compared to Amap and Baidu, the Tencent Location Service official website provides less detailed secondary descriptions of features and lacks thorough usage examples, which is less friendly to novice developers.
  2. Smaller Community Presence: Outside of mini-program development, there are fewer developer discussions and third-party resources, making it harder to find quick solutions when encountering issues.
  3. Limited Support for Independent Applications: When integrated into web pages or standalone software, lacks engaging feature showcases, reducing appeal for developers eager for rapid prototyping.
  4. High Barrier to Customization: If offline deployment or feature customization is required, requests must be submitted through business cooperation, with a non-transparent process unsuitable for agile development needs.

Application Scenario

Tencent Maps API is widely used in fields such as smart mobility, logistics, cultural tourism, retail, and social networking. It provides ride-hailing platforms with driver-passenger simultaneous display, route planning, and order mileage calculation; helps logistics companies optimize efficiency through address resolution, truck navigation, and batch route calculation; supports scenic spots with hand-drawn map navigation, real-time visitor heatmap guidance, and AR navigation; assists chain brands in digital store management and sales representative store visit route planning; and deeply integrates with the WeChat ecosystem to enable location-based content association in mini-programs, offering a closed-loop experience from discovery to navigation and store arrival.

Example

1. Tencent Maps JavaScript API GL.

File Opening Method

1. Tencent Maps collection interface.

Related GIS Services

LocationIQ API

Geoapify Maps & Location API

Stadia Maps API

Thunderforest Maps API

References

  1. https://www.tencentcloud.com/document/product/1219/57775?lang=en&pg=
  2. https://bellingcat.gitbook.io/toolkit/more/all-tools/tencent-maps
  3. https://packagist.org/packages/a-pie/tencent-map-api