# ug
Utils using Google API
To install: ```pip install ug```
You'll also need to get a [Google API key](https://support.google.com/googleapi/answer/6158862?hl=en)
and enable the maps services for it.
When you call a function, in the `gmaps_client`, you can specify the key itself
or can specify the environment variable (prefixed with `"$"`) where you stored it,
or even a fully instantiated client you made yourself.
If you don't specify anything, it will use `"$GOOGLE_API_KEY"` as the default
(so will look for an API key in the `GOOGLE_API_KEY` environment variable).
# Examples
## Google maps
```python
>>> r = search_maps("meditation", "Aix-en-Provence", radius_in_meters=3000)
>>> len(r)
10
>>> [x['formatted_address'] for x in r] # doctest: +SKIP
['90A Rue Jean Dausset, 13090 Aix-en-Provence, France',
'24 Rue Thiers, 13100 Aix-en-Provence, France',
...
'700 Chem. de Banon, 13100 Aix-en-Provence, France',
'31 Cr Gambetta 13100, 13090 Aix-en-Provence, France']
>>> r[0] # doctest: +SKIP
'business_status': 'OPERATIONAL',
'formatted_address': '90A Rue Jean Dausset, 13090 Aix-en-Provence, France',
'geometry': {'location': {'lat': 43.53714249999999, 'lng': 5.4149873},
'viewport': {'northeast': {'lat': 43.53849157989272,
'lng': 5.416325329892722},
'southwest': {'lat': 43.53579192010728, 'lng': 5.413625670107278}}},
'icon': 'https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/school-71.png',
'icon_background_color': '#7B9EB0',
'icon_mask_base_uri': 'https://maps.gstatic.com/mapfiles/place_api/icons/v2/school_pinlet',
'name': 'Pleine conscience aix',
'opening_hours': {'open_now': True},
'photos': [{'height': 1067,
'html_attributions': ['<a href="https://maps.google.com/maps/contrib/114127511381087003840">A Google User</a>'],
'photo_reference': 'AdCG2DNSD6nzorLbQagoMyC_ATRfKWAtXYzDknmBYspoXGnJzeqxScNA3VIhF4wPKkAuI3W4KBOEvibZenNuO0qRVbNYkBFUahJSRPXJjtHFQj4nBur4auszmIwykM8QoMxcrHucGcwcYbj3GZnat1r6nDJXWAKrWLDEqbf9P4mVDoFIr7Vg',
'width': 1600}],
'place_id': 'ChIJbc-zeTeNyRIRrtgswndfJ34',
'plus_code': {'compound_code': 'GCP7+VX Aix-en-Provence',
'global_code': '8FM7GCP7+VX'},
'rating': 5,
'reference': 'ChIJbc-zeTeNyRIRrtgswndfJ34',
'types': ['school', 'health', 'point_of_interest', 'establishment'],
'user_ratings_total': 3}
```
Raw data
{
"_id": null,
"home_page": "https://github.com/thorwhalen/ug",
"name": "ug",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": null,
"author": "Thor Whalen",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/b6/88/2d4b6556536498e600ecc35b02f2970456dd7100dd0837a222de4f65b36e/ug-0.0.11.tar.gz",
"platform": "any",
"description": "# ug\n\nUtils using Google API\n\nTo install:\t```pip install ug```\n\nYou'll also need to get a [Google API key](https://support.google.com/googleapi/answer/6158862?hl=en)\nand enable the maps services for it. \n\nWhen you call a function, in the `gmaps_client`, you can specify the key itself \nor can specify the environment variable (prefixed with `\"$\"`) where you stored it, \nor even a fully instantiated client you made yourself. \nIf you don't specify anything, it will use `\"$GOOGLE_API_KEY\"` as the default \n(so will look for an API key in the `GOOGLE_API_KEY` environment variable).\n\n\n# Examples\n\n## Google maps\n\n```python\n>>> r = search_maps(\"meditation\", \"Aix-en-Provence\", radius_in_meters=3000)\n>>> len(r)\n10\n>>> [x['formatted_address'] for x in r] # doctest: +SKIP\n['90A Rue Jean Dausset, 13090 Aix-en-Provence, France',\n'24 Rue Thiers, 13100 Aix-en-Provence, France',\n...\n'700 Chem. de Banon, 13100 Aix-en-Provence, France',\n'31 Cr Gambetta 13100, 13090 Aix-en-Provence, France']\n>>> r[0] # doctest: +SKIP\n'business_status': 'OPERATIONAL',\n'formatted_address': '90A Rue Jean Dausset, 13090 Aix-en-Provence, France',\n'geometry': {'location': {'lat': 43.53714249999999, 'lng': 5.4149873},\n'viewport': {'northeast': {'lat': 43.53849157989272,\n 'lng': 5.416325329892722},\n'southwest': {'lat': 43.53579192010728, 'lng': 5.413625670107278}}},\n'icon': 'https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/school-71.png',\n'icon_background_color': '#7B9EB0',\n'icon_mask_base_uri': 'https://maps.gstatic.com/mapfiles/place_api/icons/v2/school_pinlet',\n'name': 'Pleine conscience aix',\n'opening_hours': {'open_now': True},\n'photos': [{'height': 1067,\n'html_attributions': ['<a href=\"https://maps.google.com/maps/contrib/114127511381087003840\">A Google User</a>'],\n'photo_reference': 'AdCG2DNSD6nzorLbQagoMyC_ATRfKWAtXYzDknmBYspoXGnJzeqxScNA3VIhF4wPKkAuI3W4KBOEvibZenNuO0qRVbNYkBFUahJSRPXJjtHFQj4nBur4auszmIwykM8QoMxcrHucGcwcYbj3GZnat1r6nDJXWAKrWLDEqbf9P4mVDoFIr7Vg',\n'width': 1600}],\n'place_id': 'ChIJbc-zeTeNyRIRrtgswndfJ34',\n'plus_code': {'compound_code': 'GCP7+VX Aix-en-Provence',\n'global_code': '8FM7GCP7+VX'},\n'rating': 5,\n'reference': 'ChIJbc-zeTeNyRIRrtgswndfJ34',\n'types': ['school', 'health', 'point_of_interest', 'establishment'],\n'user_ratings_total': 3}\n```\n",
"bugtrack_url": null,
"license": "mit",
"summary": "Utils using Google API",
"version": "0.0.11",
"project_urls": {
"Homepage": "https://github.com/thorwhalen/ug"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8f337800c611c9aa1cadce97b3c3a12683389076e3c8cd72b2657c52845f2a14",
"md5": "c1d05098e7efdcb8461698cc74dfe138",
"sha256": "8afbc3a8d48ec34996d835570caf627a4a2794b3389e6e16bb3c7016dabdd810"
},
"downloads": -1,
"filename": "ug-0.0.11-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c1d05098e7efdcb8461698cc74dfe138",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 8670,
"upload_time": "2024-11-19T15:39:59",
"upload_time_iso_8601": "2024-11-19T15:39:59.868452Z",
"url": "https://files.pythonhosted.org/packages/8f/33/7800c611c9aa1cadce97b3c3a12683389076e3c8cd72b2657c52845f2a14/ug-0.0.11-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b6882d4b6556536498e600ecc35b02f2970456dd7100dd0837a222de4f65b36e",
"md5": "f78dc7990ccca384beaff5edb9616087",
"sha256": "7a99458cff5d78ddbb4b12fb0901d091e26d199b9372c1675112fd50e6ab5817"
},
"downloads": -1,
"filename": "ug-0.0.11.tar.gz",
"has_sig": false,
"md5_digest": "f78dc7990ccca384beaff5edb9616087",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 7951,
"upload_time": "2024-11-19T15:40:00",
"upload_time_iso_8601": "2024-11-19T15:40:00.682861Z",
"url": "https://files.pythonhosted.org/packages/b6/88/2d4b6556536498e600ecc35b02f2970456dd7100dd0837a222de4f65b36e/ug-0.0.11.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-19 15:40:00",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "thorwhalen",
"github_project": "ug",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "ug"
}
JSON
