این سند شامل پاسخ به سوالات متداول در مورد Places API است. اگر نمی‌توانید پاسخ سوال خود را اینجا پیدا کنید، ممکن است برخی از صفحات زیر مفید باشند.
- سوالات متداول توسعه‌دهندگان نقشه گوگل
- شرایط خدمات پلتفرم نقشه‌های گوگل
- سیاست‌های توسعه‌دهندگان Places API
API مکان‌ها همچنین یک جامعه توسعه‌دهندگان فعال دارد. اگر در مورد کد خود سؤالی دارید، توصیه می‌کنیم سؤال خود را در این جامعه مطرح کنید. اطلاعات بیشتر در مورد پرسیدن سؤال را می‌توانید در صفحه پشتیبانی بیابید.
جستجوی مکان‌ها
چرا وقتی بر اساس نوع فیلتر می‌کنم، بعضی جاها نمایش داده نمی‌شوند؟
ممکن است مکانی که به دنبال آن هستید هنوز دسته‌بندی نشده باشد. همه مکان‌ها به عنوان نوع عمومی " establishment " دسته‌بندی می‌شوند تا زمانی که گوگل اطلاعات کافی در مورد یک مکان برای دسته‌بندی آن به عنوان یکی از انواع مکان‌های پشتیبانی شده داشته باشد.
به عنوان یک راه حل، می‌توانید type مکان را به پارامتر keyword ارسال کنید. پارامتر keyword با موارد زیر مطابقت دارد: نام، نوع، آدرس و نظرات مشتریان.
اگر می‌خواهید type دسته‌بندی را خودتان به فهرست مکان‌ها اضافه کنید، ویرایش مکان را ارسال کنید . پس از تأیید و انتشار، ویرایش با استفاده از فیلتر type صحیح نمایش داده می‌شود.
چرا بعضی از مکان‌های نزدیک بازگردانده نشده‌اند؟
به طور پیش‌فرض، API مکان‌ها نتایج را بر اساس prominence در radius ارائه شده مرتب می‌کند. یک درخواست جستجوی نزدیک می‌تواند تا ۶۰ نتیجه را که در سه صفحه تقسیم شده‌اند، بازگرداند. اگر مکانی از prominence رتبه ۲۲ را داشته باشد، در صفحه دوم نتایج ظاهر می‌شود که می‌توانید از طریق صفحه‌بندی به آن دسترسی داشته باشید. اگر مکانی prominence رتبه‌ای بالاتر از ۶۰ داشته باشد، حتی اگر به مرکز جستجوی شما نزدیک‌تر باشد، در نتیجه جستجو نمایش داده نمی‌شود.
شما می‌توانید نتایج خود را به جای prominence ، بر اساس distance مرتب کنید. برای این کار، پارامتر rankby را در پرس‌وجوی خود روی distance تنظیم کنید و پارامتر radius را حذف کنید. ارتباط نادیده گرفته می‌شود و مکان‌ها به ترتیب فاصله از location نمایش داده می‌شوند.
اگر درخواست خود را بر اساس نوع فیلتر می‌کنید، ممکن است برخی از نتایج از پاسخ حذف شوند. برای اطلاعات بیشتر، به مدخل سوالات متداول مراجعه کنید: چرا وقتی بر اساس نوع فیلتر می‌کنم، برخی از مکان‌ها نمایش داده نمی‌شوند؟
چرا هنگام فیلتر کردن بر اساس برخی types ، حداکثر دو نتیجه دریافت می‌کنم؟
API مکان‌ها به گونه‌ای طراحی شده است که فهرستی از establishments نزدیک (هر چیزی از جدول اول در انواع مکان‌های پشتیبانی‌شده) و حداکثر دو نتیجه مکان (هر چیزی از جدول دوم انواع مکان‌های پشتیبانی‌شده) را برای کمک به شناسایی منطقه‌ای که درخواست جستجوی نزدیک را برای آن انجام می‌دهید، برگرداند.
فیلتر کردن درخواست جستجوی نزدیک شما بر اساس type مکان، مانند locality یا political ، نتایج establishment را فیلتر می‌کند.
داده های مکانی
چگونه می‌توانم مکان‌ها را اضافه یا ویرایش کنم؟
اگر صاحب یک کسب و کار هستید، می‌توانید با استفاده از «نمایه کسب و کار» ، فهرست‌های کسب و کار خود را در نقشه‌های گوگل اضافه، تأیید و مدیریت کنید.
اگر صاحب آن مکان نیستید، همچنان می‌توانید تغییراتی را پیشنهاد دهید .
عیب‌یابی
چرا مدام "status": "REQUEST_DENIED" دریافت می‌کنم؟
"status": "REQUEST_DENIED" توسط Places API در موارد زیر برگردانده می‌شود:
- شما API مکان‌ها را در کنسول Google Cloud فعال نکرده‌اید.
- پارامتر
keyدر درخواست شما وجود ندارد. - پارامتر
keyبا کلید API شما در کنسول Google Cloud مطابقت ندارد. - کلید API شما به درستی در کنسول Google Cloud تنظیم نشده است:
- اگر از کلید API محدود شده توسط مرورگر استفاده می‌کنید، بررسی کنید که ارجاع‌دهنده(های) مجاز شما صحیح باشند.
- اگر از کلید API محدود شده توسط سرور استفاده می‌کنید، بررسی کنید که IP(های) مجاز شما صحیح باشند.
- کلیدهای API با محدودیت‌های اندروید یا iOS پشتیبانی نمی‌شوند. از یک کلید API عمومی (بدون محدودیت) یا کلیدی با محدودیت‌های مرورگر یا سرور استفاده کنید.
- درخواست به صورت
HTTPSارسال نشده است،HTTPSبرای همه درخواست‌های Places API الزامی است. -
HTTP methodنادرستی برای ارسال درخواست استفاده شده است.