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