با میانای برنامه‌سازی کاربردی «نمایه کسب‌وکار»، می‌توانید پلاتفرمی برای فروشندگان خود ایجاد کنید تا کسب‌وکارشان را در Google مدیریت کنند. در پلاتفرم خود، می‌توانید به شرکایتان اجازه دهید فهرستگان‌هایی را که با نام، نشانی، و داده‌های تلفن کسب‌وکارشان مطابقت دارد جستجو کنند. آن‌ها می‌توانند مالکیت مکانی را اثبات کنند و همچنین مکان فیزیکی کسب‌وکار را به‌طور دقیق براساس عرض و طول جغرافیایی تعیین کنند.
قبل‌از شروع
پیش‌از استفاده از میانای برنامه‌سازی کاربردی «نمایه کسب‌وکار»، باید برنامه‌تان را ثبت کنید و اطلاعات اعتباری OAuth 2.0 را دریافت کنید. برای جزئیات درباره نحوه شروع کار با میاناهای برنامه‌سازی کاربردی «نمایه کسب‌وکار»، راه‌اندازی اولیه را ببینید.
نحوه کار با داده‌های نشانی
برای کار با داده‌های نشانی و موقعیت جغرافیایی در پلاتفرم خود، می‌توانید از دو مجموعه متفاوت از میاناهای برنامه‌سازی کاربردی و منابع استفاده کنید: میاناهای برنامه‌سازی کاربردی «نمایه کسب‌وکار» و Maps API.
منابع پراستفاده «نمایه کسب‌وکار»
GoogleLocations API به فروشنده امکان می‌دهد ازقبل ببیند که آیا مکان ازقبل در «نمایه کسب‌وکار» ادعای مالکیت شده است یا نه. اگر نه، به فروشنده اجازه می‌دهد فوراً درخواست دسترسی به آن را بدهد.
شیء PostalAddress نشان‌دهنده نشانی فیزیکی
کسب‌وکار است.
منابع Google Maps که معمولاً استفاده می‌شود
ابزاره‌های مکان جاوا اسکریپت Maps معمولاً در گردش‌های کاری شریک برای ایجاد نقشه تعاملی استفاده می‌شوند. علاوه‌براین، میاناهای برنامه‌سازی کاربردی Maps زیر نیز مفید هستند:
- با تکمیل خودکار جا و جزئیات جا، پیش‌بینی‌های جا را برگردانید. برای جزئیات قیمت‌گذاری، SKU: تکمیل خودکار (همراه با جزئیات مکان‌ها) – برای هر جلسه را ببینید.
- با جستجوی جاها، اطلاعات مکان را پُرسمان کنید. برای جزئیات قیمت‌گذاری، SKU: Find Place را ببینید.
- با زمین‌کدیابی، زمین‌کدیابی و زمین‌کدیابی معکوس نشانی‌ها را ارائه دهید. برای جزئیات قیمت‌گذاری، SKU: Geocoding را ببینید.
یک یا صفر مورد منطبق
وقتی شریکی برای فهرست‌های منطبق با مکانی جستجو می‌کند، هدفش این است که نتایج جستجو را به یک یا صفر مورد منطبق محدود کند. این یعنی مکان یا با معیارهای جستجوی آن‌ها مطابقت دارد یا هنوز در «نمایه کسب‌وکار» وجود ندارد، به‌ترتیب.
اگر یک یا صفر مورد منطبق وجود دارد، از روش
accounts.locations.create
برای ایجاد فهرستگان جدید استفاده کنید، یا راهنمای
GoogleLocations را برای
ادعای مالکیت فهرستگان موجود دنبال کنید. اگر Google نتواند نشانی را زمین‌کدیابی کند، ایجاد مکان ناموفق خواهد بود و پاسخ میانای برنامه‌سازی کاربردی شامل درخواستی برای داده‌های LatLng خواهد بود. برای کسب اطلاعات درباره نحوه ارائه داده‌های LatLng توسط فروشنده، به اصلاح دستی داده‌های موقعیت جغرافیایی مراجعه کنید.
وقتی مختصات LatLng تعیین شد، فهرستگان جدید ایجاد می‌شود.
مطابقت‌های جزئی و چندگانه
وقتی مالک کسب‌وکار یا تیم عملیات شریک فهرست‌هایی را جستجو می‌کند که با مکانی مطابقت دارد، اطلاعاتی که تایپ می‌کند ممکن است فقط به مطابقت جزئی منجر شود یا ممکن است چندین مطابقت برای پرسمان جستجوی خود دریافت کند. برای محدود کردن نتایج جستجو به یک یا صفر مورد منطبق، موارد منطبق جزئی و چندگانه به‌طور دستی توسط دو مورد استفاده Maps API حل می‌شوند.
کاربر جستجویش را پالایش می‌کند
وقتی کاربر پلاتفرم شریک مکانی را جستجو می‌کند و با چند مورد منطبق جزئی مواجه می‌شود، می‌تواند مشکل را به یکی از روش‌های زیر حل کند:
- نشانی‌های منطبق جزئی را تحلیل کنید و نشانی درست را انتخاب کنید.
- بخش‌هایی از نشانی را ویرایش یا دوباره تایپ کنید تا دقیق‌تر شود و نتایج آن به یک یا صفر مورد منطبق محدود شود.
کاربر از بین یک یا چند مورد کاملاً منطبق انتخاب می‌کند
در برخی موارد، ممکن است چند مکان کاملاً با نشانی جستجوشده کاربر مطابقت داشته باشد. برای مثال، ممکن است کاربر نشانی زیر را در پلاتفرم شریک وارد کند:
Burung kolibri, Collmin Sq., GRN No. 1, Wonokromo, Jawa Timur 60983, Indonesia
فرض کنید پاسخ‌های زیر برگردانده شده‌اند که همگی با نشانی ارائه‌شده مطابقت دارند:
- Kasperson Printer Center، مکانی تأییدنشده.
- Bengo Seguro، مکانی درستی‌سنجی‌شده.
- Garush Productions، مکانی درستی‌سنجی‌نشده.
کاربر باید کسب‌وکار منطبق را به‌صورت دستی انتخاب کند. برای اطمینان از اینکه مسیرهای دقیقی به کسب‌وکار به مصرف‌کنندگان ارائه می‌شود، ممکن است لازم باشد داده‌های طول و عرض جغرافیایی (LatLng) این مکان‌ها برای ارائه دقت بالاتر اصلاح شود. برای کسب اطلاعات درباره نحوه وارد کردن دستی LatLng توسط کاربران،
تنظیم دستی داده‌های مکان جغرافیایی را ببینید.
تنظیم دستی داده‌های مکان جغرافیایی
کسب‌وکارها می‌توانند مختصات طول و عرض جغرافیایی (LatLng) کسب‌وکارشان را اضافه کنند تا دقت فهرستگانشان را در «نمایه کسب‌وکار» افزایش دهند. کسب‌وکارهای جدید ممکن است مختصات LatLng خود را ندانند، بنابراین می‌توانند به‌جای آن به‌طور دستی سنجاقی را با ابزاره مکان‌های جاوا اسکریپت Maps رها کنند تا مختصات LatLng دقیقی را ایجاد کنند.
LatLng
آن، باید مختصات هر مکان را به‌صورت دستی
تنظیم کنید.کیفیت نتایج جستجو
نتایج جستجو براساس دقت نشانی جستجوشده و منطقه جغرافیایی بسیار متفاوت است. مناطق درحال توسعه اغلب مکان‌های Maps کمتری را نشان می‌دهند و با قالب‌های نشانی Google مطابقت ندارند. این امر منجر به نتایج جستجوی با کیفیت پایین‌تر و افزایش نیاز به قالب‌بندی دستی نشانی و استفاده از Maps API می‌شود.