Cómo comenzar con la API de Google Maps Places (nueva) en Python

La API de Google Maps Places es una poderosa herramienta que permite a los desarrolladores acceder a información detallada sobre lugares de todo el mundo. En este tutorial, lo guiaremos a través del proceso de uso de la nueva API de Google Maps Places en Python, desde la configuración de su proyecto de Google Cloud hasta la realización de solicitudes de API y el manejo de respuestas.

¿Qué es la API de lugares de Google Maps?

Google Maps tiene dos versiones de la API de Places:

1. API heredada – Permite la conexión con una simple clave API.
2. API de próxima generación – Requiere OAuth 2.0 para la autenticación y proporciona funciones más avanzadas.

Configurando su proyecto de Google Cloud

1. Navegue a la consola de Google Cloud: Ir a Consola de Google Cloud.
2. Crear un proyecto: Si no tiene un proyecto, cree uno haciendo clic en el menú desplegable y seleccionando "Nuevo proyecto".
3. Habilitar API y servicios: Vaya a API y servicios > Panel y habilite la API de Places.
4. Configurar OAuth 2.0: Vaya a API y servicios > Pantalla de consentimiento de OAuth, configure la pantalla de consentimiento y cree credenciales de OAuth 2.0.

Autenticar con OAuth 2.0

1. Crear ID de cliente de OAuth: Elija "Aplicación de escritorio" como tipo de aplicación y descargue el archivo secreto del cliente.
2. Instalar las bibliotecas necesarias: Utilice pip para instalar la biblioteca cliente de Google Python y el paquete dotenv de Python.

pip install google-auth google-auth-oauthlib google-auth-httplib2 google-api-python-client python-dotenv

Realizar solicitudes de API

Inicializando el cliente API

Cree un script de Python (por ejemplo, maps_textsearch.py) e inicialice el cliente API utilizando las credenciales descargadas.

from google.oauth2 import service_account
from googleapiclient.discovery import build
import json

def create_service(client_secret_file, api_name, api_version, scopes):
    credentials = service_account.Credentials.from_service_account_file(client_secret_file, scopes=scopes)
    return build(api_name, api_version, credentials=credentials)

CLIENT_SECRET_FILE = 'path/to/client_secret.json'
API_SERVICE_NAME = 'places'
API_VERSION = 'v1'
SCOPES = ['https://www.googleapis.com/auth/maps']

service = create_service(CLIENT_SECRET_FILE, API_SERVICE_NAME, API_VERSION, SCOPES)

Ejemplo: búsqueda de texto

Definir parámetros de búsqueda: Crea una consulta para buscar lugares específicos.

 query = 'ramen places in New York'
response = service.places().textSearch(query=query).execute()
print(json.dumps(response, indent=4))

Manejar la respuesta: Extrae y muestra información relevante.

for place in response['results']:
    print(place['name'], place['formatted_address'])

Ejemplo: detalles del lugar

Obtener detalles del lugar: recupere información detallada sobre un lugar específico utilizando su ID de lugar.

place_id = 'ChIJN1t_tDeuEmsRUsoyG83frY4'
response = service.places().get(place_id=place_id).execute()
print(json.dumps(response, indent=4))

Mostrar detalles: Extrae e imprime detalles como reseñas, horarios de apertura, etc.

print('Name:', response['name'])
print('Address:', response['formatted_address'])
print('Phone:', response['formatted_phone_number'])

Precios y cuotas

Google ofrece $200 de crédito gratuito al mes para todos los productos de Maps. Controle su uso para evitar cargos inesperados.

Conclusión

Si sigue estos pasos, podrá integrar con éxito la API de Google Maps Places en sus aplicaciones Python, proporcionando datos enriquecidos relacionados con lugares para mejorar la experiencia del usuario.

Tabla: Puntos clave

Fragmento de código de ejemplo

from google.oauth2 import service_account
from googleapiclient.discovery import build

def create_service(client_secret_file, api_name, api_version, scopes):
    credentials = service_account.Credentials.from_service_account_file(client_secret_file, scopes=scopes)
    return build(api_name, api_version, credentials=credentials)

CLIENT_SECRET_FILE = 'path/to/client_secret.json'
API_SERVICE_NAME = 'places'
API_VERSION = 'v1'
SCOPES = ['https://www.googleapis.com/auth/maps']

service = create_service(CLIENT_SECRET_FILE, API_SERVICE_NAME, API_VERSION, SCOPES)

query = 'ramen places in New York'
response = service.places().textSearch(query=query).execute()
print(json.dumps(response, indent=4))

for place in response['results']:
    print(place['name'], place['formatted_address'])

Si sigue esta guía, podrá comenzar fácilmente con la API de Google Maps Places y desbloquear una gran cantidad de datos basados en la ubicación para sus aplicaciones. ¡Disfruta explorando el mundo de Google Maps!