חיפוש כרטיסי מוצר תואמים

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

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

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

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

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

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

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

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

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

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

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

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

כשיש התאמה אחת או אפס התאמה, יוצרים דף אפליקציה חדש באמצעות השיטה accounts.locations.create, או פועלים לפי המדריך GoogleLocations כדי לתבוע בעלות על הדף העסקי הקיים. אם ל-Google לא תהיה אפשרות לבצע קידוד גיאוגרפי של הכתובת, יצירת המיקום תיכשל ותגובת ה-API תכלול בקשה לנתוני LatLng. במאמר התאמה ידנית של נתוני המיקום הגיאוגרפי מוסבר איך המוכר יכול לספק את הנתונים שלו לגבי LatLng.

לאחר קביעת הקואורדינטות של LatLng, ייווצר דף אפליקציה חדש.

התאמות חלקיות והתאמות מרובות

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

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

  • נתחו את הכתובות התואמות חלקית ובחרו את הכתובת הנכונה.
  • אפשר לערוך או להקליד מחדש חלקים של הכתובת כדי שיהיו מדויקים יותר ולצמצם את התוצאות להתאמה אחת או אפס.
משתמש נתקל בכמה התאמות חלקיות בתגובה לחיפוש הכתובת שלו.

המשתמש בוחר מתוך התאמה מלאה אחת או יותר

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

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

נניח שהוחזרו התשובות הבאות, שכולן תואמות לכתובת שנמסרה:

  • Kasperson Device Center, מיקום לא מאומת.
  • Bengo Seguro, מיקום מאומת.
  • Garush Productions, מיקום לא מאומת.

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

התאמה ידנית של נתוני המיקום הגיאוגרפי

עסקים יכולים להוסיף את הקואורדינטות של קווי האורך והרוחב (LatLng) של העסק כדי לשפר את הדיוק של הדף העסקי שלהם בפרופיל העסק. ייתכן שעסקים חדשים לא ידעו את הקואורדינטות של LatLng, ולכן הם יכולים להציב סיכה באופן ידני באמצעות הווידג'ט של מקומות JavaScript במפות Google כדי ליצור קואורדינטות LatLng מדויקות.

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

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

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