Python میں Google Maps Places (New) API کے ساتھ کیسے شروعات کریں۔

Google Maps Places API ایک طاقتور ٹول ہے جو ڈویلپرز کو دنیا بھر کے مقامات کے بارے میں تفصیلی معلومات تک رسائی کی اجازت دیتا ہے۔ اس ٹیوٹوریل میں، ہم آپ کے گوگل کلاؤڈ پروجیکٹ کو ترتیب دینے سے لے کر API کی درخواستیں کرنے اور جوابات کو سنبھالنے تک، Python میں نئے Google Maps Places API کو استعمال کرنے کے عمل میں آپ کی رہنمائی کریں گے۔

Google Maps Places API کیا ہے؟

Google Maps میں Places API کے دو ورژن ہیں:

1. Legacy API - ایک سادہ API کلید کے ساتھ کنکشن کی اجازت دیتا ہے۔
2. اگلی نسل کا API - تصدیق کے لیے OAuth 2.0 کی ضرورت ہے اور مزید جدید خصوصیات فراہم کرتا ہے۔

اپنا گوگل کلاؤڈ پروجیکٹ ترتیب دینا

1. گوگل کلاؤڈ کنسول پر جائیں۔: کے پاس جاؤ گوگل کلاؤڈ کنسول.
2. ایک پروجیکٹ بنائیں: اگر آپ کے پاس کوئی پروجیکٹ نہیں ہے تو ڈراپ ڈاؤن مینو پر کلک کرکے اور "نیا پروجیکٹ" کو منتخب کرکے ایک بنائیں۔
3. APIs اور خدمات کو فعال کریں۔: APIs اور خدمات > ڈیش بورڈ پر جائیں، اور Places API کو فعال کریں۔
4. OAuth 2.0 سیٹ اپ کریں۔: APIs اور خدمات > OAuth Consent Screen پر جائیں، رضامندی کی اسکرین سیٹ اپ کریں، اور OAuth 2.0 کی اسناد بنائیں۔

OAuth 2.0 کے ساتھ تصدیق کرنا

1. OAuth کلائنٹ ID بنائیں: ایپلیکیشن کی قسم کے طور پر "ڈیسک ٹاپ ایپ" کو منتخب کریں اور کلائنٹ کی خفیہ فائل ڈاؤن لوڈ کریں۔
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 Maps کے تمام پروڈکٹس کے لیے ہر ماہ $200 مفت کریڈٹ پیش کرتا ہے۔ غیر متوقع چارجز سے بچنے کے لیے اپنے استعمال کی نگرانی کریں۔

نتیجہ

ان اقدامات پر عمل کرتے ہوئے، آپ Google Maps Places API کو کامیابی کے ساتھ اپنی Python ایپلی کیشنز میں ضم کر سکتے ہیں، صارف کے تجربے کو بڑھانے کے لیے جگہ سے متعلق بھرپور ڈیٹا فراہم کر سکتے ہیں۔

ٹیبل: کلیدی نکات

مثال کوڈ کا ٹکڑا

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 کی دنیا کو دریافت کرنے کا لطف اٹھائیں!