سرویس‌های کلیدی قابل اجرا با Places API (New)
Google Places API چندین روش (Endpoint) برای جستجو و دریافت جزئیات مکان ارائه می‌دهد که هر کدام برای یک سناریوی خاص طراحی شده‌اند:
| سرویس | کاربرد اصلی | مثال پروژه |
| Autocomplete (تکمیل خودکار) | پیشنهاد دادن نام مکان‌ها یا جستجوها در حین تایپ کاربر. | فیلد جستجوی آدرس در یک اپلیکیشن تحویل غذا. |
| Text Search (جستجوی متنی) | جستجوی مکان‌ها بر اساس یک رشته متنی عمومی. | جستجوی متنی مانند: “بهترین رستوران‌های ایتالیایی در شیراز”. |
| Nearby Search (جستجوی نزدیک) | پیدا کردن مکان‌ها بر اساس نزدیکی به یک نقطه خاص و نوع مکان. | نمایش تمامی “پمپ بنزین‌ها” یا “کافی‌شاپ‌ها” در شعاع ۵ کیلومتری کاربر. |
| Place Details (جزئیات مکان) | دریافت اطلاعات کامل و جامع یک مکان بر اساس شناسه منحصر به فرد (Place ID). | نمایش آدرس کامل، شماره تلفن، رتبه‌بندی، ساعات کاری و نقدهای یک رستوران. |
| Place Photos (عکس‌های مکان) | دسترسی به میلیون‌ها عکس باکیفیت ذخیره‌شده از مکان‌ها. | نمایش گالری عکس‌های یک هتل یا مرکز خرید در اپلیکیشن مسافرتی. |
نمونه پروژه ها و راهکارها (Use Cases)
این API امکان اجرای طیف وسیعی از قابلیت‌های مبتنی بر مکان را فراهم می‌کند:
- تجارت الکترونیک و تحویل: فعال کردن قابلیت تکمیل خودکار آدرس دقیق برای کاربران هنگام ثبت سفارش یا افزودن آدرس جدید (با استفاده از Autocomplete و Place Details).
- مسافرت و گردشگری: ایجاد یک راهنمای محلی (Local Guide) که نقاط مورد علاقه نزدیک (Nearby Search) به هتل یا جاذبه‌های گردشگری را نمایش دهد و جزئیات کامل آن‌ها (Place Details) را ارائه کند.
- اپلیکیشن‌های شبکه‌سازی محلی: کمک به کاربران برای “Check-in” کردن در کسب‌وکارهای مجاور.
- یافتن نمایندگی و خدمات: نمایش مکان تمام شعب یک فروشگاه زنجیره‌ای یا تعمیرگاه‌های مجاز روی نقشه و ارائه اطلاعات تماس آن‌ها.
- بهبود داده‌ها: غنی‌سازی پایگاه داده داخلی شرکت با داده‌های استاندارد شده (مانند Place ID و آدرس دقیق) از گوگل.
پروژه‌های موفق و اپلیکیشن‌های استفاده کننده
اکثر اپلیکیشن‌ها و سایت‌هایی که نیاز به تعامل با نقشه‌ها و مکان‌ها دارند، از این سرویس استفاده می‌کنند. هر پلتفرمی که فیلد جستجوی آدرس هوشمند، پیشنهاد مکان‌های نزدیک یا نمایش جزئیات کسب‌وکارها را دارد، احتمالاً از Places API استفاده می‌کند.
- سرویس‌های تاکسی آنلاین (مانند Uber/Lyft): استفاده از Autocomplete برای ورود سریع و دقیق مبدأ و مقصد.
- پلتفرم‌های رزرو سفر (مانند Expedia, Booking.com): نمایش اطلاعات جامع هتل‌ها و جاذبه‌های گردشگری.
- اپلیکیشن‌های تحویل غذا و فروشگاه‌های آنلاین: تأیید آدرس تحویل و پیشنهاد فروشگاه‌های نزدیک.
نمونه کد (مثال جستجوی نزدیک)
برای جستجوی مکان‌های نزدیک (Nearby Search) به یک نقطه، میتوانید از یک درخواست HTTP ساده استفاده کنید (البته استفاده از Client Libraryهای گوگل برای زبان‌های مختلف توصیه می‌شود).
ساختار کلی درخواست Nearby Search (Web Service API):
https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=-33.8670522,151.1957362&radius=500&type=restaurant&key=YOUR_API_KEYتوضیح پارامترها:
- location: مختصات جغرافیایی مرکز جستجو (عرض و طول جغرافیایی).
- radius: شعاع جستجو بر حسب متر (در این مثال ۵۰۰ متر).
- type: نوع مکان مورد نظر (مثلاً
restaurant). - key: کلید API شما.
ساختار هزینه‌ها و قیمت‌گذاری
Google Maps Platform از یک مدل پرداخت به ازای استفاده (Pay-as-you-go) پیروی می‌کند که بر اساس SKU (واحد ذخیره‌سازی سهام) یا نوع درخواست، محاسبه می‌شود.
| نوع درخواست (SKU) | ساختار هزینه | نکته کلیدی |
| Autocomplete Requests | بر اساس تعداد درخواست‌ها | هرچه تعداد درخواست‌ها بالاتر، هزینه هر ۱۰۰۰ درخواست کمتر می‌شود. |
| Place Details | بر اساس دریافت جزئیات یک مکان با Place ID | گران‌تر از جستجوی ساده است، زیرا داده‌های بیشتری دریافت می‌شود. |
| Text/Nearby Search | بر اساس تعداد جستجوها | بسته به SKU (Essentials یا Pro) قیمت‌ها متفاوت است. |
- اعتبار رایگان ماهانه: گوگل به طور پیش‌فرض هر ماه یک مقدار مشخصی تماس رایگان (Free Calls) برای هر SKU در اختیار کاربران قرار می‌دهد (این مقدار جایگزین اعتبار ۲۰۰ دلاری سابق شده است). برای حجم‌های پایین یا توسعه، این مقدار اغلب کافی است.
- نکته مهم در هزینه‌سازی: برای کاهش هزینه در جستجو، همیشه از Field Masking استفاده کنید. یعنی در درخواست‌های
Place DetailsیاSearch، فقط فیلدهایی (مانندdisplayName,formattedAddress) را درخواست کنید که واقعاً به آن‌ها نیاز دارید.
برای اطلاعات بیشتر در مورد پیاده‌سازی و کدنویسی، میتوانید ویدیوی زیر را ببینید. این ویدیو معرفی‌ای از نسخه جدید Places API است که می‌تواند برای درک آخرین تغییرات و به‌روزرسانی‌ها مفید باشد.
برای دریافت API_Key میتوانید به پشتیبانی شرکت تجارت پایدار ایرانیان مراجعه نمایید یا از طریق شماره تلفن مشاوره بگیرید.
