چرا از Places API استفاده کنید
ویژگیهای آگاه از موقعیت مکانی را ایجاد کنید تا دادههای مکان دقیق را به راحتی در دسترس کاربران خود قرار دهید. دادههای موجود از طریق Places API بر اساس یکی از دقیقترین، بهروزترین و جامعترین مدلهای مکان در دنیای واقعی ساخته شدهاند. در اینجا نمونه هایی از موارد استفاده برای برنامه ها آورده شده است:
- کاندوهای اجارهای در کلانشهرهای اصلی را با نتایجی که بهطور خاص برای شهرها هدفگذاری شده است، نمایش دهید.
- جزئیات مکان را در بهروزرسانی وضعیت تحویل یا تحویل درج کنید.
- نمایش لیستی از پارک ها در یک منطقه به همراه عکس ها و نظرات ارسال شده توسط کاربر.
- به افرادی که برای سفر برنامه ریزی می کنند، اطلاعات تماس، نظرات و سطوح قیمت را برای موسسات در مسیر ارائه دهید.
با Places API چه کاری می توانید انجام دهید
می توانید از Places API برای گنجاندن ویژگی های زیر در برنامه های خود استفاده کنید:
- نتایج جستجوی مکان را از انواع مختلف درخواستهای کاربران، مانند ورودی متن، مکانهای نزدیک، و جستارهای مبهم یا طبقهبندی شده کاربر ارائه دهید.
- ویژگی های تکمیل خودکار را برای انواع مختلف جستجو، اعم از عبارت های متنی خاص یا جستارهای دسته بندی، فعال کنید.
- نوع جزئیات بازگردانده شده درباره یک مکان، مانند ساعات کار، خلاصه، نظرات کاربران و یک عکس را اصلاح کنید.
- عکسهای باکیفیت را به مکانهایی که برنامه شما ارائه میکند اضافه کنید.
نحوه عملکرد Places API
Places API درخواست ها را به عنوان یک URL استاندارد با یک نقطه پایانی سرویس خاص، مانند /place
یا /photo
می پذیرد. نقاط پایانی نیز نوع فرمت مشخص شده در درخواست، JSON یا XML را می پذیرند. در نهایت، درخواست سرویس از پارامترهای مربوط به آن نقطه پایانی خاص برای اصلاح داده های برگشتی استفاده می کند. به عنوان مثال، درخواست Place Details زیر برای اجزای آدرس به صورت زیر عمل می کند، با فرض بازگشت در قالب JSON:
https://maps.googleapis.com/maps/api/place/details/json ?place_id=ChIJrTLr-GyuEmsRBfy61i59si0 &fields=address_components &key=YOUR_API_KEY
در این مثال، سرویس از شناسه مکان ارائه شده برای یافتن مکان درخواستی و برگرداندن اجزای آدرس در قالب JSON استفاده می کند.
منابع
جدول زیر منابع موجود از طریق Places API را به همراه داده هایی که برمی گرداند خلاصه می کند.
منابع داده | داده ها برگردانده شد | فرمت بازگشت |
---|---|---|
جستجوی مکان | فهرستی از مکانها را بر اساس مکان دستگاه یا رشته جستجو برمیگرداند. جزئیات پاسخهای جستجوی مکان ، پاسخهای جستجوی نزدیک ، و پاسخهای جستجوی متنی را ببینید. |
|
جزئیات مکان | اطلاعات دقیقتری درباره یک مکان خاص، از جمله نظرات کاربران، برمیگرداند. جزئیات را در پاسخهای جزئیات مکان ببینید. |
|
عکس ها را قرار دهید | دسترسی به میلیونها عکس مرتبط با مکان را که در پایگاه داده Google Place ذخیره شدهاند، فراهم میکند. جزئیات پاسخ عکسهای مکان را ببینید. |
|
محل تکمیل خودکار | به طور خودکار نام و/یا آدرس یک مکان را هنگام تایپ کاربران پر می کند. جزئیات مربوط به پاسخهای تکمیل خودکار مکان را ببینید. |
|
پرس و جو تکمیل خودکار | یک سرویس پیشبینی پرس و جو را برای جستجوهای جغرافیایی مبتنی بر متن ارائه میکند، و هنگام تایپ کاربران، عبارتهای پیشنهادی را برمیگرداند. جزئیات پاسخهای تکمیل خودکار Query را ببینید. |
|
نحوه استفاده از Places API
مراحل زیر یک سناریوی مورد استفاده معمولی را برای استفاده از سه نقطه پایانی در سرویس Places API پوشش میدهد. همانطور که راه حل خود را ایجاد می کنید، می توانید از نقاط پایانی اضافی مانند جستجوی نزدیک، عکس های مکان، و تکمیل خودکار درخواست استفاده کنید.1 | راه اندازی را دریافت کنید | با راهاندازی پروژه Google Cloud خود شروع کنید و دستورالعملهای راهاندازی را تکمیل کنید و سپس نحوه استفاده از کلید API خود را بیاموزید. |
2 | یک جستجوی متنی اولیه را امتحان کنید | هنگامی که یک کلید API دارید، یک جستجوی متنی ساده همانطور که در مثالهای جستجوی متن اصلی در راهنمای جستجوی متن نشان داده شده است، صادر کنید. |
3 | از درخواست Find Place استفاده کنید | درخواستهای Find Place یک شناسه مکان را به همراه فیلدهای دادهای که درخواست میکنید، مانند ساعات کاری، آدرس و عکسها، برمیگردانند. نمونههای Find Place را ببینید و یکی دیگر از موارد مرتبط با مورد استفاده خود را امتحان کنید. |
4 | اصول پاسخ یافتن مکان را درک کنید | دادههای بازگشتی از پاسخ Find Place را کاوش کنید. برای جزئیات بیشتر به یافتن پاسخهای مکان مراجعه کنید. |
5 | برای جزئیات بیشتر از شناسه مکان استفاده کنید | پاسخ های Find Place همه داده های موجود برای یک مکان خاص را ارائه نمی دهند. میتوانید از شناسه مکان بازگردانده شده از پاسخ یافتن مکان برای دریافت جزئیات بیشتر در مورد یک مکان استفاده کنید. جزئیات مکان را ببینید. |
کتابخانه های مشتری موجود
این API را به زبان انتخابی خود از طریق یکی از کتابخانه های سرویس گیرنده زیر فراخوانی کنید:
- Java Client برای خدمات Google Maps
- کلاینت پایتون برای خدمات نقشه های گوگل
- Go Client برای خدمات Google Maps
- Node.js Client برای خدمات Google Maps
Java Client، Python Client، Go Client و Node.js Client برای سرویسهای Google Maps، کتابخانههای مشتری پشتیبانی شده توسط جامعه هستند که تحت مجوز Apache 2.0 منبع باز هستند. آنها را از GitHub دانلود کنید، جایی که می توانید دستورالعمل های نصب و کد نمونه را پیدا کنید.
بعدش چی
- استفاده از جستجوی API Places را شروع کنید : به جستجوی مکان بروید.
- دریافت یک کلید API : به استفاده از کلیدهای API بروید