בעזרת ממשקי Business Profile API, אתם יכולים ליצור פלטפורמה שבה המוכרים שלכם יוכלו לנהל את העסק שלהם ב-Google. בפלטפורמה שלכם, אתם יכולים לאפשר לשותפים לחפש דפי פרטי עסק שתואמים לשם, לכתובת ולמספר הטלפון של העסק שלהם. הם יכולים להוכיח בעלות על מיקום, וגם להגדיר במדויק את המיקום הפיזי של העסק לפי קו רוחב וקו אורך.
לפני שמתחילים
לפני שמשתמשים בממשקי Business Profile API, צריך לרשום את האפליקציה ולקבל פרטי כניסה ל-OAuth 2.0. במאמר הגדרה בסיסית מוסבר איך מתחילים לעבוד עם ממשקי Business Profile API.
איך לעבוד עם נתוני כתובות
כדי לעבוד עם נתוני כתובות ומיקום גיאוגרפי בפלטפורמה שלכם, אתם יכולים להשתמש בשתי קבוצות שונות של ממשקי API ומשאבים: ממשקי ה-API של פרופיל העסק ב-Google וממשק ה-API של מפות Google.
מקורות מידע נפוצים על פרופיל העסק ב-Google
GoogleLocations API מאפשר למוכר לראות מראש אם כבר נתבעה בעלות על מיקום בפרופיל העסק. אם לא, המוכר יכול לבקש גישה אליו באופן מיידי.
האובייקט PostalAddress מייצג את הכתובת הפיזית של העסק.
מקורות מידע נפוצים על מפות Google
הווידג'טים של Places ב-Maps JavaScript משמשים בדרך כלל בתהליכי עבודה של שותפים כדי ליצור מפה אינטראקטיבית. בנוסף, ממשקי ה-API הבאים של מפות Google יכולים להיות שימושיים:
- החזרת חיזויים של מקומות באמצעות השלמה אוטומטית למקומות ו-Place Details. לפרטים על המחירים, ראו מק"ט: השלמה אוטומטית (כלולה ב-Places Details) – לכל סשן.
- שליחת שאילתה לקבלת מידע על מקומות באמצעות חיפוש מקומות. לפרטי התמחור, ראו מק"ט: Find Place.
- המרת כתובות לקואורדינטות (geocoding) והמרת קואורדינטות לכתובות (reverse geocoding). לפרטי התמחור, ראו מק"ט: המרת כתובות לקואורדינטות (geocoding).
התאמה אחת או אפס התאמות
כשהשותף מחפש דפים תואמים למיקום, המטרה שלו היא לצמצם את תוצאות החיפוש להתאמה אחת או לאפס התאמות. כלומר, המיקום מתאים לקריטריונים של החיפוש או שהוא עדיין לא קיים בפרופיל העסק, בהתאמה.
אם יש התאמה אחת או אפס התאמות, משתמשים ב-method 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, ולכן הם יכולים להציב סיכה באופן ידני באמצעות הווידג'ט של Places ב-Maps JavaScript כדי לקבוע קואורדינטות מדויקות של LatLng.
LatLng, צריך לשנות ידנית את הקואורדינטות של כל מיקום.איכות תוצאות החיפוש
תוצאות החיפוש משתנות מאוד בהתאם לדיוק של הכתובת שמחפשים ולאזור הגיאוגרפי. באזורים מתפתחים יש בדרך כלל פחות מקומות במפות Google, והם לא תמיד תואמים לפורמטים של הכתובות ב-Google. כתוצאה מכך, איכות תוצאות החיפוש יורדת וצריך לעצב את הכתובות באופן ידני ולהשתמש ב-Maps API בתדירות גבוהה יותר.