חיפוש נכסים תואמים

באמצעות ממשקי ה-API של פרופיל העסק, אתם יכולים ליצור פלטפורמה למוכרים שבה הם יוכלו לנהל את העסק שלהם ב-Google. בפלטפורמה שלכם, תוכלו לאפשר לשותפים לחפש כרטיסי מוצר שתואמים לשם, לכתובת ולמספר הטלפון של העסק שלהם. הם יכולים לקבוע בעלות על מיקום, וגם למקם במדויק את המיקום הפיזי של העסק לפי קו הרוחב וקו האורך.

לפני שמתחילים

לפני שמשתמשים בממשקי Business Profile API, צריך לרשום את האפליקציה ולקבל פרטי כניסה ל-OAuth 2.0. למידע נוסף על תחילת העבודה עם ממשקי Business Profile API, קראו את המאמר הגדרה בסיסית.

איך עובדים עם נתוני כתובות

כדי לעבוד עם נתוני כתובות ומיקום גיאוגרפי בפלטפורמה שלכם, אתם יכולים להשתמש בשתי קבוצות שונות של משאבים וממשקי API: ממשקי ה-API של 'פרופיל העסק ב-Google' וממשק ה-API של מפות Google.

משאבים נפוצים בפרופיל העסק

ה-API של GoogleLocations מאפשר למוכרים לראות מראש אם כבר הוגשה תלונה לגבי מיקום מסוים בפרופיל העסק. אם לא, היא מאפשרת למוכרים לבקש גישה אליו באופן מיידי.

האובייקט PostalAddress מייצג את הכתובת הפיזית של העסק.

משאבים נפוצים של מפות Google

ווידג'טים של מיקומים ב-JavaScript במפות Google משמשים בדרך כלל בתהליכי העבודה של שותפים כדי ליצור מפה אינטראקטיבית. בנוסף, כדאי להשתמש בממשקי ה-API הבאים של מפות Google:

אפס או התאמה אחת

כששותף מחפש כרטיסי מוצר תואמים למיקום מסוים, המטרה שלו היא לצמצם את תוצאות החיפוש להתאמה אחת או לאף התאמה. פירוש הדבר הוא שהמיקום עומד בקריטריונים של החיפוש שלהם, או שהוא עדיין לא קיים בפרופיל העסק.

אם יש התאמה אחת או אפס התאמות, משתמשים בשיטה accounts.locations.create כדי ליצור כרטיס מוצר חדש, או פועלים לפי המדריך GoogleLocations כדי לטעון בעלות על כרטיס המוצר הקיים. אם Google לא מצליחה לבצע קידוד גיאוגרפי של הכתובת, יצירת המיקום נכשלת ותשובת ה-API כוללת בקשה לנתוני 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, ולכן הם יכולים להשתמש במקום זאת בווידג'ט של מפות Google ל-JavaScript כדי להציב סיכה באופן ידני ולקבוע קואורדינטות LatLng מדויקות.

כתובת אחת מנותבת לשלושה מיקומים במרחק 457 מטרים זה מזה. כדי לשייך במדויק את כתובת העסק לקואורדינטות LatLng שלו, צריך לשנות באופן ידני את הקואורדינטות של כל מיקום.

איכות תוצאות החיפוש

תוצאות החיפוש משתנות מאוד בהתאם לדיוק הכתובת שנמצאת בחיפוש, ולפי האזור הגיאוגרפי. באזורים מתפתחים בדרך כלל מוצגים פחות מקומות במפות Google, ויש אי-עקביות בתאימות לפורמטים של כתובות של Google. כתוצאה מכך, תוצאות החיפוש יהיו באיכות נמוכה יותר, ויהיה צורך רב יותר בפורמט ידני של כתובות ובשימוש ב-Maps API.