पायथन में Google मैप्स स्थान (नया) API के साथ कैसे आरंभ करें

Google Maps Places API एक शक्तिशाली टूल है जो डेवलपर्स को दुनिया भर के स्थानों के बारे में विस्तृत जानकारी तक पहुँचने की अनुमति देता है। इस ट्यूटोरियल में, हम आपको अपने Google Cloud प्रोजेक्ट को सेट करने से लेकर API अनुरोध करने और प्रतिक्रियाओं को संभालने तक, Python में नए Google Maps Places API का उपयोग करने की प्रक्रिया के बारे में मार्गदर्शन करेंगे।

गूगल मैप्स प्लेस एपीआई क्या है?

गूगल मैप्स में स्थान API के दो संस्करण हैं:

1. विरासत एपीआई - एक सरल एपीआई कुंजी के साथ कनेक्शन की अनुमति देता है।
2. अगली पीढ़ी का एपीआई - प्रमाणीकरण के लिए OAuth 2.0 की आवश्यकता होती है और यह अधिक उन्नत सुविधाएँ प्रदान करता है।

अपना Google क्लाउड प्रोजेक्ट सेट अप करना

1. Google क्लाउड कंसोल पर नेविगेट करें: जाओ गूगल क्लाउड कंसोल.
2. एक प्रोजेक्ट बनाएंयदि आपके पास कोई प्रोजेक्ट नहीं है, तो ड्रॉप-डाउन मेनू पर क्लिक करके और "नया प्रोजेक्ट" चुनकर एक प्रोजेक्ट बनाएं।
3. API और सेवाएँ सक्षम करें: API और सेवाएँ > डैशबोर्ड पर जाएँ और स्थान API सक्षम करें.
4. OAuth 2.0 सेट अप करें: API और सेवाएँ > OAuth सहमति स्क्रीन पर जाएँ, सहमति स्क्रीन सेट करें, और OAuth 2.0 क्रेडेंशियल बनाएँ।

OAuth 2.0 के साथ प्रमाणीकरण

1. OAuth क्लाइंट आईडी बनाएंएप्लिकेशन प्रकार के रूप में "डेस्कटॉप ऐप" चुनें और क्लाइंट सीक्रेट फ़ाइल डाउनलोड करें।
2. आवश्यक लाइब्रेरीज़ स्थापित करें: Google Python क्लाइंट लाइब्रेरी और Python dotenv पैकेज को स्थापित करने के लिए pip का उपयोग करें।

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

API अनुरोध करना

API क्लाइंट को आरंभ करना

एक पायथन स्क्रिप्ट बनाएं (उदाहरण के लिए, maps_textsearch.py) और डाउनलोड किए गए क्रेडेंशियल्स का उपयोग करके API क्लाइंट को प्रारंभ करें।

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)

उदाहरण: पाठ खोज

खोज पैरामीटर परिभाषित करें: विशिष्ट स्थानों की खोज के लिए एक क्वेरी बनाएं.

 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'])

उदाहरण: स्थान विवरण

स्थान विवरण प्राप्त करें: किसी विशिष्ट स्थान के बारे में उसकी स्थान आईडी का उपयोग करके विस्तृत जानकारी प्राप्त करें।

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

प्रदर्शन विवरण: समीक्षाएँ, खुलने का समय आदि जैसे विवरण निकालें और प्रिंट करें।

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

मूल्य निर्धारण और कोटा

Google सभी मैप्स उत्पादों के लिए प्रति माह $200 का निःशुल्क क्रेडिट प्रदान करता है। अप्रत्याशित शुल्क से बचने के लिए अपने उपयोग पर नज़र रखें।

निष्कर्ष

इन चरणों का पालन करके, आप अपने पायथन अनुप्रयोगों में Google मानचित्र स्थान API को सफलतापूर्वक एकीकृत कर सकते हैं, जिससे उपयोगकर्ता अनुभव को बढ़ाने के लिए समृद्ध स्थान-संबंधी डेटा उपलब्ध हो सकेगा।

तालिका: मुख्य बिंदु

उदाहरण कोड स्निपेट

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'])

इस गाइड का पालन करके, आप आसानी से Google Maps Places API का उपयोग शुरू कर सकते हैं और अपने अनुप्रयोगों के लिए स्थान-आधारित डेटा का खजाना अनलॉक कर सकते हैं। Google Maps की दुनिया का आनंद लें!