visgl / visgl/react-google-maps
[Bug] MapTypeControl cannot switch from hybrid/satellite to roadmap when initialized with hybrid/satellite in 45° imagery areas
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 1.9k
- Forks
- 193
- Avg merge
- 3d 16h
- Merged PRs (30d)
- 13
Description
Description
When a map is initialized with mapTypeId="hybrid" or mapTypeId="satellite" and the user is viewing a location with 45° imagery available, clicking the "Map" button in the native mapTypeControl fails to switch to roadmap view.
The map briefly flickers (appears to attempt the switch) but immediately reverts back to hybrid/satellite view. This only occurs in areas where 45° imagery is available and at zoom levels where tilt is active.
Workarounds
Option 1: Controlled state with onMapTypeIdChanged
Using React state to manage mapTypeId and syncing it via onMapTypeIdChanged resolves the issue:
import { APIProvider, Map, type MapProps } from '@vis.gl/react-google-maps'
import { useState } from 'react'
const MAP_ID = 'YOUR_MAP_ID' // Must have vector maps enabled
function App() {
const [mapTypeId, setMapTypeId] = useState<MapProps['mapTypeId']>('hybrid')
return (
<APIProvider apiKey="YOUR_API_KEY">
<Map
style={{ width: '100%', height: '500px' }}
defaultCenter={{ lat: 48.8630, lng: 2.3622 }} // Paris 3e - has 45° imagery
defaultZoom={18}
mapTypeId={mapTypeId}
mapTypeControl
mapId={MAP_ID}
onMapTypeIdChanged={(event) => setMapTypeId(event.map.getMapTypeId())}
/>
</APIProvider>
)
}
Option 2: Initialize as roadmap and switch after mount
Initializing without mapTypeId prop and programmatically switching to hybrid after mount also works:
import { APIProvider, Map, useMap } from '@vis.gl/react-google-maps'
import { useEffect } from 'react'
const MAP_ID = 'YOUR_MAP_ID' // Must have vector maps enabled
const SwitchToHybridOnMount = () => {
const map = useMap()
useEffect(() => {
if (!map) return
const timer = setTimeout(() => {
map.setMapTypeId('hybrid')
}, 50)
return () => clearTimeout(timer)
}, [map])
return null
}
function App() {
return (
<APIProvider apiKey="YOUR_API_KEY">
<Map
style={{ width: '100%', height: '500px' }}
defaultCenter={{ lat: 48.8630, lng: 2.3622 }} // Paris 3e - has 45° imagery
defaultZoom={18}
// Note: mapTypeId prop must NOT be provided (even undefined won't work)
mapTypeControl
mapId={MAP_ID}
>
<SwitchToHybridOnMount />
</Map>
</APIProvider>
)
}
Observations
- ✅ Works: Initialize with
roadmaporterrain→ switch to hybrid → switch back to roadmap - ❌ Fails: Initialize with
hybridorsatellite→ cannot switch to roadmap (in 45° areas) - ✅ Works: Same scenario in non-45° areas (low zoom or locations without 45° imagery)
- ✅ Works: Native Google Maps API without react-google-maps wrapper (tested via Google's demo)
- ✅ Works: Using controlled state with
onMapTypeIdChangedto syncmapTypeId - ✅ Works: Not providing
mapTypeIdprop and switching viamap.setMapTypeId()after mount
Possible causes
- When
mapTypeIdis passed as a static prop, the library may be forcing it back to the initial value on every camera/tilt change event - The internal reconciliation between Google Maps state and React props seems to conflict with the automatic tilt behavior in 45° areas
- Using controlled state via
onMapTypeIdChangedallows the component to accept the new mapTypeId from Google Maps instead of reverting it - Not providing the
mapTypeIdprop at all lets Google Maps maintain full control over the map type state
Steps to Reproduce
- Initialize a map with
mapTypeId="hybrid"ormapTypeId="satellite"as a static prop (not via useState) - Navigate to a location with 45° imagery (e.g., Paris 3e Arrondissement)
- Zoom in until the 45° tilt view activates
- Click the "Map" button in the mapTypeControl
- Expected: Map switches to roadmap view
- Actual: Map flickers briefly then stays in hybrid/satellite view
Minimal reproduction
import { APIProvider, Map } from '@vis.gl/react-google-maps'
const MAP_ID = 'YOUR_MAP_ID' // Must have vector maps enabled
function App() {
return (
<APIProvider apiKey="YOUR_API_KEY">
<Map
style={{ width: '100%', height: '500px' }}
defaultCenter={{ lat: 48.8630, lng: 2.3622 }} // Paris 3e - has 45° imagery
defaultZoom={18}
mapTypeId="hybrid" // Bug occurs with static hybrid or satellite
mapTypeControl
mapId={MAP_ID}
/>
</APIProvider>
)
}
Environment
- Library version:
^1.7.1 - Google maps version:
3.62 - Browser and Version:
Firefox 147.0.1 - OS:
macOS Tahoe 26.2
Logs
As of version 3.62, Maps JavaScript API satellite and hybrid map types will no longer automatically switch to 45° Imagery at higher zoom levels. For more info, see https://developers.google.com/maps/deprecations
(I know it's outdated, but as long as it works, I'd like to use it)
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the Map component's static mapTypeId handling and the mapTypeId/onMapTypeIdChanged paths described in the report. Reproduce the minimal example in a 45° imagery area, then trace whether reconciliation restores the initial value; done means the native Map control can switch from hybrid or satellite to roadmap without reverting.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- react, typescript
- Domain
- api, frontend
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100