set to multi polygon

[hasush]

Hello, I am having some problems finding the equivalent of h3_set_to_multi_polygon in either 3.7.7 or 4.3.0.

For example, the following:

Python 3.9.13 | packaged by conda-forge | (main, May 27 2022, 16:58:50) 
[GCC 10.3.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> import h3
>>> print(dir(h3))
['H3BaseException', 'H3CellInvalidError', 'H3DirEdgeInvalidError', 'H3DomainError', 'H3DuplicateInputError', 'H3FailedError', 'H3GridNavigationError', 'H3LatLngDomainError', 'H3MemoryAllocError', 'H3MemoryBoundsError', 'H3MemoryError', 'H3NotNeighborsError', 'H3OptionInvalidError', 'H3PentagonError', 'H3ResDomainError', 'H3ResMismatchError', 'H3Shape', 'H3UndirEdgeInvalidError', 'H3ValueError', 'H3VertexInvalidError', 'LatLngMultiPoly', 'LatLngPoly', 'Literal', 'UnknownH3ErrorCode', '__builtins__', '__cached__', '__doc__', '__file__', '__loader__', '__name__', '__package__', '__path__', '__spec__', '__version__', '_cy', '_h3shape', '_version', 'api', 'are_neighbor_cells', 'average_hexagon_area', 'average_hexagon_edge_length', 'cell_area', 'cell_to_boundary', 'cell_to_center_child', 'cell_to_child_pos', 'cell_to_children', 'cell_to_children_size', 'cell_to_latlng', 'cell_to_local_ij', 'cell_to_parent', 'cell_to_vertex', 'cell_to_vertexes', 'cells_to_directed_edge', 'cells_to_geo', 'cells_to_h3shape', 'child_pos_to_cell', 'compact_cells', 'directed_edge_to_boundary', 'directed_edge_to_cells', 'edge_length', 'geo_to_cells', 'geo_to_h3shape', 'get_base_cell_number', 'get_directed_edge_destination', 'get_directed_edge_origin', 'get_icosahedron_faces', 'get_num_cells', 'get_pentagons', 'get_res0_cells', 'get_resolution', 'great_circle_distance', 'grid_disk', 'grid_distance', 'grid_path_cells', 'grid_ring', 'h3shape_to_cells', 'h3shape_to_cells_experimental', 'h3shape_to_geo', 'int_to_str', 'is_pentagon', 'is_res_class_III', 'is_valid_cell', 'is_valid_directed_edge', 'is_valid_vertex', 'latlng_to_cell', 'local_ij_to_cell', 'origin_to_directed_edges', 'polygon_to_cells', 'polygon_to_cells_experimental', 'str_to_int', 'uncompact_cells', 'versions', 'vertex_to_latlng']
>>> h3.__version__
'4.3.0'

tells me that 'geo_to_cells' or 'geo_to_h3shape' could be relevant. Looking through the docs:

• https://uber.github.io/h3-py/polygon_tutorial.html
• https://uber.github.io/h3-py/api_quick
  I see that those as well as the LatLngPoly/LatLngMultiPoly objects.

I just want to confirm this is the correct way to go and if there is any documentation/explicit examples for conversion between the h3_set_to_multi_polygon and the new methods.

Thank you!

[ajfriend]

That's correct. Take a look at https://uber.github.io/h3-py/api_quick#polygon-interface and https://uber.github.io/h3-py/polygon_tutorial.html

It sounds like you probably want https://uber.github.io/h3-py/api_verbose.html#h3.cells_to_h3shape or https://uber.github.io/h3-py/api_verbose.html#h3.cells_to_geo

If you think the docs could be improved for future folks in your situation, I'm always happy to hear feedback!

[hasush]

Hey thanks for the quick reply. Will take a look at this. Thank you!