Add Google map tiles

[giswqs]

The PR adds a google_map_tiles() function for for generating Google Map tiles. To get an API key and enable Map Tiles API, visit https://developers.google.com/maps/get-started#create-project. The API key can be set as an environment variable MAPS_API_KEY or as a Colab secret.

@jdbcode @naschmitz For now, I only add the fucntion to generate the xyzservices.TileProvider. Two more things to discuss:

• Whether to add googlemaps as a core dependency
• Whether to add Google Map tiles by default if the environment variable MAPS_API_KEY is detected

import os
os.environ["MAPS_API_KEY"] = "YOUR-API-KEY"

import geemap
m = geemap.Map()
# The map type can be 'roadmap', 'satellite', 'terrain', 'hybrid', 'traffic', 'streetview'
basemap = geemap.google_map_tiles(map_type='hybrid')  
m.add_basemap(basemap)
m

style = [
    {
      "stylers": [
        { "hue": "#00ffe6" },
        { "saturation": -20 }
      ]
    },{
      "featureType": "road",
      "elementType": "geometry",
      "stylers": [
        { "lightness": 100 },
        { "visibility": "simplified" }
      ]
    }
  ]

m = geemap.Map()
basemap = geemap.google_map_tiles(map_type="roadmap",region="CN", language="zh-Cn", scale='scaleFactor2x', highDpi=True, style=style)
m.add_basemap(basemap)
m

[github-actions]

🚀 Deployed on https://66513f991de522a8eb819af2--opengeos.netlify.app

[jdbcode]

Nice! Thanks, Qiusheng. I've left some minor comments for discussion. Also...

• Whether to add googlemaps as a core dependency
• Whether to add Google Map tiles by default if the environment variable MAPS_API_KEY is detected

These two seem connected. I think we should try to make adding these tiles as easy as possible, which would requires the package be available and fetching stored Maps API key.

The googlemaps package looks a little stale (not much activity on the repo), we should find out what its status is and if the maps team is supporting it. If they are, we should try to get installed in Colab and make sure it is available on Conda-Forge. If maps team is not supporting it, we should discuss what that means.

[jdbcode]

Looking again, I don't think googlemaps is needed. The client that was created in the demo is never actually used 🤦. I tested the workflow without the googlemaps parts and it's fine. So, we can just move forward - no additional dependencies to worry about. Can you please remove the googlemaps parts.

[giswqs]

@jdbcode That's great. I was wondering the same thing when implementing it. I have removed it. Will address other comments later today.

[jdbcode]

Thanks for removing googlemaps! No rush on the other changes, we could wait until @naschmitz has a chance to comment too.

[giswqs]

The map_type parameter accepts one of the three case insensitive variatioins, such as Roadmap, Google Roadmap, and Google.Roadmap

[giswqs]

The next step is to add Google Map tiles by default if the environment variable MAPS_API_KEY is detected. The will require making changes to core.py

[jdbcode]

Sounds good, thanks for the progress. I'll be at EGU next week, so may not respond right away if you post something.

[giswqs]

I have improved the function. It now supports returning all gmap providers when map_type=None.

# returns all gmap providers as a dict when map_type is None, which can be accessed via providers['roadmap'], providers['hybrid']
providers = geemap.google_map_tiles(map_type=None) 

# returns a specific gmap provider
geemap.google_map_tiles(map_type='roadmap', language="en-Us", region="US", scale="scaleFactor2x", highDpi=True)

[giswqs]

@naschmitz Good suggestions. I will resolve them this Friday after I return from the conference.

[giswqs]

Sorry for the delay. I have been traveling the past few days. Will resume working on this tomorrow.

[giswqs]

@naschmitz @jdbcode I have implemented all suggested changes. If the MAPS_API_KEY environment variable is detected, Google map tiles can will be used. Otherwise, the alternative Esri basemaps will be used.

Set environment variable

import os
os.environ["MAPS_API_KEY"] = "YOUR_API_KEY"

Get a single Google tile provider

from geemap.basemaps import GoogleMapsTileProvider
GoogleMapsTileProvider(map_type='hybrid')

Get all Google tiles as a dictionary

from geemap.basemaps import google_map_tiles
google_map_tiles()

Use geemap.core

import geemap.core as geemap
m = geemap.Map()
m

import geemap.core as geemap
m = geemap.Map(basemap="Hybrid")
m

Use geemap

import geemap
m = geemap.Map()
m.add_basemap("Google.Satellite")
m

[naschmitz]

@giswqs - I made a bunch of changes. Mostly removing the dependencies on hardcoded map name prefixes. Please take a look when you have time.

[giswqs]

LGTM.

[giswqs]

@naschmitz Thank you for making those changes. It looks great to me. I made some minor changes to allow the basemap to accept a string, such as OpenTopoMap.

[jdbcode]

🗺️❤️👏