Metadata-Version: 2.1
Name: gomaps
Version: 0.2.4
Summary: A Google Maps search API for web scraping place data
Home-page: https://github.com/jakeee51/gomaps
Author: David J. Morfe
Author-email: jakemorfe@gmail.com
License: MIT
Description: <a href="https://pepy.tech/project/gomaps/month">
          <img src="https://pepy.tech/badge/gomaps/month" />
        </a>
        
        <a href="https://gomaps.readthedocs.io/en/latest/">
          <img src="https://readthedocs.org/projects/gomaps/badge/" />
        </a>
        
        <a href="https://travis-ci.org/github/jakeee51/gomaps">
          <img src="https://travis-ci.org/jakeee51/gomaps.svg?branch=master&status=passed" />
        </a>
        
        # The-Gomaps-Python-Package
        
        Gomaps! A Google Maps API for querying places on Google Maps and scraping the metadata of that search (No API key needed). Results of a query include the following data:
        
        * Place Name
        * Place Google Maps URL
        * Place Address
        * Place Coordinates (lattitude/longitude)
        * Place Website
        * Place Phone Number
        * Place Star Rating
        * Place Open Hours
        * Place Popular Times
        
        That's right! This can also scrape Google Maps __Popular Times__ data!
        For more information about Google's popular times data, refer to this support post: https://support.google.com/business/answer/6263531?hl=en.
        
        <h2><b>Documentation:</b></h2>
        <a href="https://gomaps.readthedocs.io/en/latest/">https://gomaps.readthedocs.io/en/latest/</a>
        
        <h2><b>Quickstart:</b></h2>
        To start, import the functions from the `gomaps` package.
        
        ```python
        from gomaps import maps_search
        
        results = maps_search("Tops Diner") # Returns a list of GoogleMaps objects
        # GoogleMapsResults([<gomaps.GoogleMaps object; Place-Name: Tops Diner>])
        
        results[0].get_values() # Populates the object's attributes & returns a dictionary
        '''
        {
          'title': 'Tops Diner',
          'url': 'https://www.google.com/maps/place/Tops+Diner/@40.7506065,-74.1639023,17z/data=!4m2!3m1!1s0x89c2547b4ec3235b:0x7342f11f69197f92!8m2!3d40.7506065!4d-74.1639023',
          'address': '500 Passaic Ave, East Newark, NJ 07029',
          'coords': ('40.7506065', '-74.1639023'),
          'website': 'https://www.thetopsdiner.com/',
          'phone_number': '(973) 481-0490',
          'rating': '4.6',
          'open_hours': {'Currently': 'Closed - Opens 8AM',
                         'Hours': {'Friday': '8AMâ€“11PM', 'Saturday': '8AMâ€“11PM', 'Sunday': '8AMâ€“11PM',
                                   'Monday': '8AMâ€“11PM', 'Tuesday': '8AMâ€“11PM', 'Wednesday': '8AMâ€“11PM', 'Thursday': '8AMâ€“11PM'}
                        }
          'popular_times': {
                            'Sunday': ['0% busy at 6 AM', '0% busy at 7 AM', '19% busy at 8 AM', '35% busy at 9 AM', '48% busy at 10 AM',
                            '52% busy at 11 AM', '49% busy at 12 PM', '44% busy at 1 PM', '45% busy at 2 PM', '49% busy at 3 PM',
                            '52% busy at 4 PM', '52% busy at 5 PM', '57% busy at 6 PM', '70% busy at 7 PM', '78% busy at 8 PM',
                            '66% busy at 9 PM', '39% busy at 10 PM', '0% busy at 11 PM'], 
                            'Monday':  ...
                            }
        }
        '''
        ```
        
        <h2><b>Patch Notes:</b></h2>
        <i><b>0.2.0</b>
          
          - A **popular_times** attribute is now appended to the GoogleMaps object! This optimizes speed, efficiency and convenience.
        
          - The **busytimes** module along with `popular_times()` function will be deprecated.
          
          - Less dependencies required (including selenium).
        </i>
        
        # Copyright
        Copyright (c) 2020 The Python Packaging Authority. Released under the MIT License.
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
