בעזרת ממשקי ה-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:
- החזר חיזויים של מקומות באמצעות השלמה אוטומטית של מקום ופרטי מקום. לפרטי תמחור, אפשר לעיין במאמר מק"ט: השלמה אוטומטית (כלולה בפרטי מקומות) – לכל סשן.
- שאילתה לקבלת פרטי מקום באמצעות חיפוש מקום. לפרטי המחירים, אפשר לעיין במק"ט: חיפוש מקום.
- להשתמש בקידוד גיאוגרפי כדי להוסיף קידוד גיאוגרפי וקידוד גיאוגרפי הפוך של כתובות. למידע על מחירים אפשר לעיין במאמר SKU: Geocoding.
התאמה אחת או אפס התאמה
כאשר שותף מחפש רישומים תואמים למיקום, המטרה שלו היא לצמצם את תוצאות החיפוש להתאמה אחת או לאפס. כלומר, המיקום עומד בקריטריונים לחיפוש שלהם או שהוא עדיין לא קיים בפרופיל העסק.
כשיש התאמה אחת או אפס התאמה, יוצרים דף אפליקציה חדש באמצעות השיטה accounts.locations.create
, או פועלים לפי המדריך GoogleLocations
כדי לתבוע בעלות על הדף העסקי הקיים. אם ל-Google לא תהיה אפשרות לבצע קידוד גיאוגרפי של הכתובת, יצירת המיקום תיכשל ותגובת ה-API תכלול בקשה לנתוני LatLng
. במאמר התאמה ידנית של נתוני המיקום הגיאוגרפי מוסבר איך המוכר יכול לספק את הנתונים שלו לגבי LatLng
.
לאחר קביעת הקואורדינטות של LatLng
, ייווצר דף אפליקציה חדש.
התאמות חלקיות והתאמות מרובות
כאשר בעלי עסק או צוות התפעול של השותף מחפשים רישומים שתואמים למיקום, המידע שהם יקלידו עשוי ליצור התאמה חלקית בלבד או לקבל מספר התאמות לשאילתת החיפוש שלהם. כדי לצמצם את תוצאות החיפוש להתאמה אחת או לאפס, התאמות חלקיות ומרובות נפתרות ידנית באמצעות שני תרחישים לדוגמה ב-API של מפות Google.
המשתמש מצמצם את החיפוש
כשמשתמש בפלטפורמה של השותף מחפש מיקום ונתקל בכמה התאמות חלקיות, הוא יכול לפתור את הבעיה באחת מהדרכים הבאות:
- נתחו את הכתובות התואמות חלקית ובחרו את הכתובת הנכונה.
- אפשר לערוך או להקליד מחדש חלקים של הכתובת כדי שיהיו מדויקים יותר ולצמצם את התוצאות להתאמה אחת או אפס.
![](https://google-developers.gonglchuangl.net/static/my-business/images/partial-match.png?authuser=0&hl=he)
המשתמש בוחר מתוך התאמה מלאה אחת או יותר
במקרים מסוימים, ייתכן שמיקומים מרובים יתאימו באופן מלא לכתובת החיפוש של המשתמש. לדוגמה, משתמש עשוי להזין את הכתובת הבאה לפלטפורמה של שותף:
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
מדויקות.
![](https://google-developers.gonglchuangl.net/static/my-business/images/latlng-manual-adjustment.png?authuser=0&hl=he)
LatLng
שלו, צריך לבצע התאמה ידנית של הקואורדינטות
של כל מיקום.איכות של תוצאות חיפוש
תוצאות החיפוש משתנות מאוד בהתאם לדיוק של הכתובת שמשתמשים מחפשים ולאזור הגיאוגרפי. אזורים מתפתחים בדרך כלל מראים פחות מקומות במפות Google ותאימות לא עקבית לפורמטים של הכתובות של Google. המצב הזה מוביל לתוצאות חיפוש באיכות נמוכה יותר וליותר צורך בעיצוב ידני של כתובות ובשימוש ב-API של מפות Google.