پرسشگان «خدمات وب مکان‌ها»

این سند حاوی پاسخ به پرسش‌های متداول درباره Places API است. اگر نمی‌توانید پاسخ سؤال خود را در اینجا پیدا کنید، ممکن است برخی از صفحات زیر برای شما مفید باشد.

‫Places API همچنین دارای یک انجمن توسعه‌دهنده پویا است. اگر درباره کدتان سؤالی دارید، توصیه می‌کنیم سؤالتان را در انجمن پست کنید. اطلاعات بیشتر درباره پرسیدن سؤال را می‌توانید در صفحه پشتیبانی پیدا کنید.

جستجوی مکان‌ها

چرا وقتی براساس نوع فیلتر می‌کنم، برخی مکان‌ها برگردانده نمی‌شوند؟

ممکن است مکانی که دنبالش می‌گردید هنوز دسته‌بندی نشده باشد. همه مکان‌ها به‌عنوان نوع عمومی «establishment» دسته‌بندی می‌شوند تا زمانی که Google داده‌های کافی درباره مکان داشته باشد تا آن را به‌عنوان یکی از انواع مکان‌های پشتیبانی‌شده دسته‌بندی کند.

به‌عنوان راه‌حل جایگزین، می‌توانید مکان type را به پارامتر keyword ارسال کنید. پارامتر keyword با این موارد مطابقت دارد: نام، نوع، نشانی، و مرورهای مشتری.

اگر می‌خواهید دسته type را خودتان به فهرست مکان اضافه کنید، ویرایش مکان ارسال کنید. پس‌از تأیید و انتشار ویرایش، بااستفاده از فیلتر type صحیح نشان داده خواهد شد.

چرا برخی‌از جاهای اطراف برگردانده نمی‌شوند؟

به‌طور پیش‌فرض، Places API نتایج را براساس prominence در radius ارائه‌شده مرتب می‌کند. درخواست جستجوی اطراف می‌تواند تا ۶۰ نتیجه را برگرداند که در سه صفحه تقسیم شده‌اند. اگر مکانی در prominence رتبه ۲۲ را داشته باشد، در صفحه دوم نتایج ظاهر می‌شود که می‌توانید ازطریق صفحه‌بندی به آن دسترسی پیدا کنید. اگر رتبه مکانی در prominence بالاتر از ۶۰ باشد، در نتایج جستجو گنجانده نخواهد شد، حتی اگر به مرکز جستجوی شما نزدیک‌تر باشد.

می‌توانید نتایج را به‌جای prominence براساس distance مرتب کنید. برای این کار، پارامتر rankby را در پُرسمان روی distance تنظیم کنید و پارامتر radius را حذف کنید. ارتباط نادیده گرفته خواهد شد و مکان‌ها به‌ترتیب فاصله از location برگردانده خواهند شد.

اگر درخواستتان را براساس نوع فیلتر می‌کنید، ممکن است برخی‌از نتایج از پاسخ فیلتر شوند. برای اطلاعات بیشتر، به ورودی پرسشگان مراجعه کنید: چرا وقتی براساس نوع فیلتر می‌کنم، برخی‌از مکان‌ها برگردانده نمی‌شوند؟.

چرا وقتی براساس برخی types فیلتر می‌کنم، حداکثر دو نتیجه دریافت می‌کنم؟

«میانای برنامه‌سازی کاربردی Places» به‌گونه‌ای طراحی شده است که فهرستی از نتایج مکان‌های اطراف establishments (هر چیزی از جدول اول در انواع مکان‌های پشتیبانی‌شده) و حداکثر دو مکان (هر چیزی از جدول دوم انواع مکان‌های پشتیبانی‌شده) را برگرداند تا به شناسایی منطقه‌ای که برای آن درخواست جستجوی اطراف ارسال می‌کنید کمک کند.

فیلتر کردن درخواست جستجوی اطراف براساس مکان type، مثل locality یا political، نتایج establishment را فیلتر می‌کند.

داده‌های مکان

چگونه می‌توانم مکان‌ها را اضافه یا ویرایش کنم؟

اگر مالک کسب‌وکاری هستید، می‌توانید بااستفاده از نمایه کسب‌وکار، فهرستگان کسب‌وکارتان را در Google Maps اضافه، درستی‌سنجی، و مدیریت کنید.

اگر مالک مکان نیستید، همچنان می‌توانید تغییراتی را پیشنهاد دهید.

عیب‌یابی

چرا مدام «وضعیت»: «REQUEST_DENIED» را دریافت می‌کنم؟

"status": "REQUEST_DENIED" توسط Places API برگردانده می‌شود وقتی:

  • Places API را در کنسول Google Cloud فعال نکرده‌اید.
  • پارامتر key در درخواست شما وجود ندارد.
  • پارامتر key با کلید میانای برنامه‌سازی کاربردی شما در کنسول Google Cloud مطابقت ندارد.
  • کلید میانای برنامه‌سازی کاربردی شما به‌درستی در کنسول Google Cloud راه‌اندازی نشده است:
    • اگر از کلید میانای API محدودشده به مرورگر استفاده می‌کنید، بررسی کنید که ارجاع‌دهنده(های) مجاز شما درست باشد.
    • اگر از کلید میانای برنامه‌سازی کاربردی محدودشده توسط سرور استفاده می‌کنید، بررسی کنید که IP(های) مجاز شما درست باشد.
    • کلیدهای میانای برنامه‌سازی کاربردی با محدودیت‌های Android یا iOS پشتیبانی نمی‌شوند. از کلید میانای API عمومی (نامحدود) یا کلیدی با محدودیت‌های مرورگر یا سرور استفاده کنید.
  • درخواست به‌عنوان درخواست HTTPS ارسال نشده است، HTTPS برای همه درخواست‌های Places API الزامی است.
  • از HTTP method نادرست برای ارسال درخواست استفاده شده است.