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