لیست های منطبق را جستجو کنید

با APIهای نمایه کسب‌وکار، می‌توانید پلتفرمی برای تاجران خود ایجاد کنید تا کسب و کار خود را در Google مدیریت کنند. در پلتفرم خود، می‌توانید به شرکای خود اجازه دهید فهرست‌هایی را جستجو کنند که با نام، آدرس و داده‌های تلفن کسب‌وکارشان مطابقت دارد. آنها می توانند مالکیت یک مکان را ایجاد کنند و همچنین موقعیت فیزیکی کسب و کار را به طور دقیق بر اساس طول و عرض جغرافیایی تعیین کنند.

قبل از اینکه شروع کنی

قبل از استفاده از API های نمایه کسب و کار، باید برنامه خود را ثبت کنید و اعتبارنامه OAuth 2.0 را دریافت کنید. برای جزئیات در مورد نحوه شروع به کار با APIهای نمایه کسب و کار، به تنظیمات اولیه مراجعه کنید.

نحوه کار با داده های آدرس

برای کار با داده‌های آدرس و موقعیت جغرافیایی در پلتفرم خود، می‌توانید از دو مجموعه مختلف از APIها و منابع استفاده کنید: APIهای نمایه تجاری و API Maps.

منابع پرکاربرد نمایه کسب و کار

GoogleLocations API به تاجر امکان می‌دهد از قبل ببیند آیا مکانی قبلاً در نمایه کسب‌وکار ادعا شده است یا خیر. در غیر این صورت، به تاجر اجازه می دهد تا فوراً درخواست دسترسی به آن را داشته باشد.

شی PostalAddress نشان دهنده آدرس فیزیکی یک کسب و کار است.

منابع Google Maps که معمولاً استفاده می شود

ابزارک Maps JavaScript Places معمولاً در گردش کار شریک برای ایجاد یک نقشه تعاملی استفاده می شود. علاوه بر این، API های Maps زیر نیز مفید هستند:

یک یا صفر کبریت

هنگامی که یک شریک لیست‌های منطبق را برای یک مکان جستجو می‌کند، هدف آنها محدود کردن نتایج جستجوی خود به یک یا صفر مطابقت است. این بدان معناست که مکان یا به ترتیب با معیارهای جستجوی آنها مطابقت دارد یا هنوز در نمایه کسب و کار وجود ندارد.

در جایی که یک یا صفر منطبق وجود دارد، از روش accounts.locations.create برای ایجاد یک فهرست جدید استفاده کنید، یا برای ادعای مالکیت فهرست موجود، راهنمای GoogleLocations را دنبال کنید. اگر Google نتواند آدرس را به صورت جغرافیایی کدگذاری کند، ایجاد مکان با شکست مواجه می‌شود و پاسخ API شامل درخواست داده‌های LatLng می‌شود. برای اطلاعات در مورد اینکه تاجر چگونه می‌تواند داده‌های LatLng خود را ارائه کند، به تنظیم دستی داده‌های موقعیت جغرافیایی مراجعه کنید.

پس از تعیین مختصات LatLng ، لیست جدید ایجاد می شود.

مسابقات جزئی و چندگانه

هنگامی که صاحب کسب و کار یا تیم عملیات شریک، فهرست‌هایی را جستجو می‌کنند که با یک مکان مطابقت دارند، اطلاعاتی که تایپ می‌کنند ممکن است فقط به یک تطابق جزئی منجر شود یا ممکن است چندین مورد منطبق با عبارت جستجوی خود دریافت کنند. برای محدود کردن نتایج جستجو به یک یا صفر مطابقت، موارد منطبق جزئی و چندگانه به صورت دستی توسط دو مورد استفاده Maps API حل می‌شوند.

هنگامی که کاربر پلتفرم شریک مکانی را جستجو می کند و با چندین تطابق جزئی مواجه می شود، می تواند مشکل را به یکی از راه های زیر حل کند:

  • آدرس های تطبیق جزئی را تجزیه و تحلیل کنید و آدرس صحیح را انتخاب کنید.
  • قسمت هایی از آدرس را ویرایش کنید یا دوباره تایپ کنید تا دقیق تر باشد و نتایج آنها را به یک یا صفر برسانید.
یک کاربر در پاسخ به جستجوی آدرس خود با چندین تطابق جزئی مواجه می شود.

کاربر از یک یا چند مسابقه کامل انتخاب می کند

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

Burung kolibri, Collmin Sq., GRN No. 1, Wonokromo, Jawa Timur 60983, Indonesia

فرض کنید پاسخ‌های زیر برگردانده شده‌اند که همگی با آدرس داده شده مطابقت دارند:

  • مرکز چاپگر Kasperson، یک مکان تأیید نشده.
  • Bengo Seguro، یک مکان تأیید شده.
  • گاروش پروداکشن، مکانی تایید نشده.

کاربر باید به صورت دستی کسب و کار منطبق را انتخاب کند. برای اطمینان از ارائه مسیرهای دقیق به سمت کسب و کار به مصرف کنندگان، داده های طول و عرض جغرافیایی ( LatLng ) برای این مکان ها ممکن است نیاز به تنظیم داشته باشند تا دقت بالاتری ارائه شود. برای اطلاعات در مورد اینکه کاربران چگونه می توانند LatLng خود را به صورت دستی وارد کنند، به تنظیم دستی داده های موقعیت جغرافیایی مراجعه کنید.

تنظیم دستی داده های موقعیت جغرافیایی

کسب و کارها می توانند مختصات طول و عرض جغرافیایی ( LatLng ) کسب و کار خود را اضافه کنند تا دقت فهرست خود را در نمایه کسب و کار افزایش دهند. کسب‌وکارهای جدید ممکن است مختصات LatLng خود را ندانند، بنابراین می‌توانند با استفاده از ابزارک Maps JavaScript Places به صورت دستی پین را برای ایجاد مختصات LatLng دقیق رها کنند.

یک آدرس واحد به سه مکان با فاصله 1500 فوت از هم مشخص می شود. برای ارتباط دقیق آدرس کسب و کار با مختصات LatLng آن، تنظیم دستی مختصات هر مکان مورد نیاز است.

کیفیت نتایج جستجو

نتایج جستجو بر اساس دقت آدرس جستجو شده و بر اساس منطقه جغرافیایی بسیار متفاوت است. مناطق در حال توسعه اغلب مکان‌های Maps کمتری را نشان می‌دهند و با قالب‌های آدرس Google مطابقت ندارند. این منجر به نتایج جستجوی با کیفیت پایین‌تر و افزایش نیاز به قالب‌بندی دستی آدرس و استفاده از Maps API می‌شود.