Ability to set centre and zoom options on basic map about gmaps

[csala]

I need to point out that currently there actually is a way to set these options, even though it's kind of a hack:

fig = gmaps.figure()

# Add any layers before the next step

fig._map.data_bounds = [
    (min_lat, min_long),
    (max_lat, max_long)
]
fig

But, again: this is just a shortcut to make it work until the right implementation is in place.

[pbugnion]

Thanks for this -- it's very very useful to have workarounds for missing features.

[pbugnion]

This is now implemented:

gmaps.figure(center=(40.75, -74.00), zoom_level=12)

center and zoom_level must either be both specified, or neither. In the case where neither are specified, the figure as behaves as before: centering on the data.

It will make its way into v0.5.3.

[CMCDragonkai]

What exactly is a zoom level? Is it some factor on height/elevation of the camera? Then does camera dimensions also matter for field of view?

…

On 8 Jul 2017 16:18, "Pascal Bugnion" ***@***.***> wrote: Closed #83 <#83>. — You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub <#83 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AAnHHQ3qZ09vawD5rScHPqp0zFk-tfShks5sLx8hgaJpZM4J0eFp> .

[pbugnion]

What exactly is a zoom level?

That's a good question. The zoom level is an integer between 0 and 21 that gets given directly to the Google Maps API (see the Google Maps documentation). It is, as you say, a factor of height / elevation of the camera (conceptually at least).

Then do camera dimensions also matter for field of view

The width and height of the map do matter for the field of view.

Note that, for now, the old 'hacky' way of overriding the map bounds explicitly also works:

fig._map.data_bounds = [
    (min_lat, min_long),
    (max_lat, max_long)
]

This guarantees that the map contains at least (min_lat, min_long) and (max_lat, max_long).

I think allowing the user to set the zoom and center is the least surprising implementation, but I'm open to adding other ways of calculating the map bounds if there is demand for it.