A Mapbox or Google map on a website for mainland China visitors has two
problems, and the firewall is the smaller one. GreatFire, which tests sites
from inside mainland China, read maps.google.com and Mapbox’s telemetry
host as blocked on 18 October 2026, and Google’s Maps API host as disrupted
in 3 of 3 tests to 30 October. The bigger problem is the law. A map shown to
the public in China has to pass a state review, and the Ministry of Natural
Resources bars embedding an unapproved one, naming foreign maps in
particular.
So the fix is a mainland provider: AMap (高德地图), Baidu Maps (百度地图) or Tencent Maps (腾讯地图). We read every verdict below at the source on 4 November 2026.
| Host | What it does | GreatFire verdict | Conclusive tests | Last tested |
|---|---|---|---|---|
maps.google.com | Google Maps site | Blocked | 3 of 3 blocked | 18 Oct 2026 |
maps.googleapis.com | Google Maps JS API | Intermittent | 3 of 3 disrupted | 30 Oct 2026 |
api.mapbox.com | Mapbox API, root | Reachable | 0 of 1 disrupted | 31 Aug 2026 |
api.mapbox.com, GL JS v3.9.0 file | Mapbox map library | Intermittent | 1 of 1 disrupted | 18 Oct 2026 |
events.mapbox.com | Mapbox telemetry | Blocked | 1 of 1 blocked | 18 Oct 2026 |
tile.openstreetmap.org | OpenStreetMap tiles | Blocked | 1 of 1 blocked | 7 Sep 2026 |
GreatFire read https://maps.google.com as blocked in 3 of 3 conclusive tests, last tested 18 October 2026, and https://maps.googleapis.com as disrupted in 3 of 3, last tested 30 October 2026. Source: GreatFire, October 2026. https://en.greatfire.org/https/maps.google.com and https://en.greatfire.org/https/maps.googleapis.com
21YunBox, the other public source of mainland probes, has published no timing for any map host. That leaves no datacentre figure and no home line figure here, only GreatFire’s reachability verdicts.
Mapbox in China: the library and the beacon
Mapbox gives two answers. The root of api.mapbox.com connected normally
in its one recent test. A copy of the map library on that same host
showed interference. (GreatFire tested version 3.9.0 of the file; the
current release is 3.34.2.)
GreatFire read https://api.mapbox.com as not blocked, 0 of 1 conclusive tests disrupted, last tested 31 August 2026, and https://api.mapbox.com/mapbox-gl-js/v3.9.0/mapbox-gl.js as disrupted in 1 of 1, last tested 18 October 2026. Across 22 tested mapbox.com URLs it counts 1 blocked, 12 disrupted some of the time and 9 loading normally. Source: GreatFire, October 2026. https://en.greatfire.org/https/api.mapbox.com and https://en.greatfire.org/domain/mapbox.com
Then there’s the telemetry. We read the source of the current release,
Mapbox GL JS 3.34.2, published on 3 November 2026. With the default API
host, the library sets its events address to events.mapbox.com/events/v2
and posts a map load event there. GreatFire has logged interference on
that host since October 2022.
GreatFire read https://events.mapbox.com as blocked in 1 of 1 conclusive tests, last tested 18 October 2026. Source: GreatFire, October 2026. https://en.greatfire.org/https/events.mapbox.com
OpenStreetMap fares worse. GreatFire counts 70 of the 72 openstreetmap.org URLs it has a verdict for as blocked, the main site included.
GreatFire read https://tile.openstreetmap.org as blocked in 1 of 1 conclusive tests, last tested 7 September 2026, and lists 70 of 72 tested openstreetmap.org URLs as blocked. Source: GreatFire, September to November 2026. https://en.greatfire.org/https/tile.openstreetmap.org and https://en.greatfire.org/domain/openstreetmap.org
The approval rule that comes before any firewall test
Suppose every host above answered. You’d still need an approved map.
China’s Map Management Regulations (地图管理条例) have applied since 1 January 2016. Under Article 15, a map shown to the public goes through state review. Article 16 adds that a map which isn’t a publication is submitted by whoever displays or posts it.
An approved map carries a review number, the 审图号 (Article 22). The services behind the maps face more. One that offers positioning or lets users add points needs a surveying qualification (测绘资质) and has to keep its map data on servers inside China (Articles 33 and 34).
A map shown to the public must be submitted for review, and a map that is not a publication is submitted by whoever displays or posts it. Source: State Council, Map Management Regulations (地图管理条例), Decree 664, 26 November 2015, Articles 15 and 16. https://www.moa.gov.cn/gk/zcfg/xzfg/201512/t20151221_4957995.htm
The Ministry of Natural Resources (自然资源部) set out what that means for a web page. Its guidance, republished by Shanghai’s planning bureau, says anyone who embeds an internet map must show its review number and copyright details on the page, with the rights holder’s consent. Embedding or linking an unapproved map is barred outright, and maps drawn by foreign authors get a mention of their own.
No unit or individual may copy, link, send, forward, quote or embed an internet map that has not been approved, in particular maps compiled by foreign authors. An internet map review number is valid for 2 years. Source: Ministry of Natural Resources, republished by the Shanghai Municipal Bureau of Planning and Natural Resources, 2 September 2020. https://ghzyj.sh.gov.cn/hyxw/20200902/a64446b1893947efb244bf9ff01bb0e2.html
For a company site, that means taking the map from a licensed mainland provider and following its terms. A CDN mirror of Mapbox tiles would only deliver the same unapproved map faster.
Why store locator pins drift off the address
The coordinates differ too. Your store list probably holds GPS coordinates, in WGS84. Mainland maps use an offset system.
AMap’s documentation names three systems. GCJ-02 is the encrypted system used inside China, and AMap’s coordinates follow it. WGS84 is what GPS devices and Google Maps use. BD-09 is Baidu’s, encrypted a second time on top of GCJ-02. Plot raw GPS points on AMap and each one sits slightly off its real address.
GCJ-02 is “the coordinate system used in China after mandatory encryption” (our translation), and AMap coordinates belong to it; BD-09, used by Baidu Maps, applies a further encryption on top of GCJ-02. Non-AMap coordinates must be converted with AMap.convertFrom(). Source: AMap Open Platform (高德开放平台), 其他坐标转高德坐标, last updated 29 July 2024. https://lbs.amap.com/api/javascript-api-v2/guide/transform/convertfrom
Baidu’s conversion API moves points between GPS, AMap, Tencent and its own system in every direction but one. It won’t turn anything back into GPS.
Baidu’s coordinate conversion API converts GPS and AMap or Tencent coordinates to BD-09, and BD-09 back to AMap or Tencent; any conversion to GPS fails with status 4, “according to legal provisions” (our translation). Source: Baidu Maps Open Platform (百度地图开放平台), 坐标转换, updated 19 March 2026. https://lbsyun.baidu.com/faq/api?title=webapi/guide/changeposition-base
Convert once per provider and keep the original GPS list as your master copy.
Swapping in AMap, Baidu Maps or Tencent Maps
All three need a developer account and an API key.
| Provider | Coordinate system | API host tested | GreatFire verdict | Setup note |
|---|---|---|---|---|
| AMap (高德地图) | GCJ-02 | webapi.amap.com | Reachable, 0 of 2, 26 Oct 2026 | Key and security key (keys since 2 Dec 2021) |
| Baidu Maps (百度地图) | BD-09 | api.map.baidu.com | Reachable, 0 of 1, 27 Sep 2026 | Key (AK); never converts to GPS |
| Tencent Maps (腾讯地图) | No dated source | map.qq.com | Untested | Key |
GreatFire read https://webapi.amap.com as not blocked, 0 of 2 conclusive tests disrupted, last tested 26 October 2026, and https://api.map.baidu.com as not blocked, 0 of 1, last tested 27 September 2026. It lists https://map.qq.com as not yet tested. Source: GreatFire, September and October 2026. https://en.greatfire.org/https/webapi.amap.com, https://en.greatfire.org/https/api.map.baidu.com and https://en.greatfire.org/https/map.qq.com
AMap keys created after 2 December 2021 only work with a paired security key. AMap would rather you kept that key on your server and passed requests through a proxy, which on a static site means one small server-side route. It also documents a plain-text setting for quick development.
Keys applied for after 2 December 2021 must be used together with a security key, which AMap recommends storing server-side behind a proxy. Source: AMap Open Platform, JS API 安全密钥使用, last updated 18 June 2025. https://lbs.amap.com/api/javascript-api-v2/guide/abc/jscode
The build we’d recommend serves two maps. Visitors in the mainland get AMap or Baidu Maps. Everyone else keeps Google or Mapbox, with the page picking one by where the request comes from. Our China Site Scanner flags Google Maps, Mapbox and OpenStreetMap calls on any page you give it. The guide to what the Great Firewall blocks covers the rest of a page’s outside hosts, and our piece on whether WordPress is blocked in China covers what a default install calls. The Shanghai team builds the swap itself under Technical Integration.
Before you swap the map: common questions
Can I keep Google Maps for mainland China visitors?
GreatFire read maps.google.com as blocked in 3 of 3 tests to 18 October
2026, and the Maps API host as disrupted in 3 of 3 to 30 October. Even on a
day it loads, it’s a foreign map without a Chinese review number. Keep it for
visitors elsewhere and serve a mainland provider inside China.
Does a Mapbox map work in China?
GreatFire’s record is mixed. It found the root of
api.mapbox.com reachable on 31 August 2026, a GL JS library file disrupted
on 18 October and the telemetry host blocked the same day. On a day it does
draw, it’s still a foreign map without a Chinese review number.
Do I need my own surveying licence to show a map?
Article 33 sets the surveying qualification for internet map services that offer positioning, user annotation or map databases. That qualification sits with the map provider. Your page embeds its approved map, shows the review number and follows its terms. If you plan to collect or publish map data of your own, take legal advice first.
Will my store addresses line up?
Only after conversion. AMap (高德地图) uses GCJ-02 and Baidu Maps (百度地图) uses BD-09, and both sit offset from GPS coordinates. Convert your list with the provider’s own tool before you plot it, and keep the GPS originals, because Baidu won’t convert back to GPS.
Need help with this?
ChinaWebFoundry handles WordPress projects in China end to end. If any of this feels like more than you want to tackle alone, get in touch.
Talk to Us