Maps JavaScript API הוא ממשק API לאינטרנט בצד הלקוח, שמאפשר ליצור מפות דו-ממדיות ותלת-ממדיות בדפי אינטרנט, להוסיף סמנים, גרפיקה בהתאמה אישית, אנימציות ושכבות נתונים אינטראקטיביות, וליצור תכונות מיקום באמצעות ספריית המקומות.
Maps JavaScript API: עובדות חשובות
- מוצר: Maps JavaScript API
- ידוע גם בשם: Maps JS API, Maps JS API v3
- קטגוריה: מפות Google
- פלטפורמה: JavaScript (דפדפן)
- פועל ב: לקוח (קוד של אפליקציה או דפדפן)
- שלב ההשקה: GA
- מחזור חיים: פעיל
- סקירה כללית: סקירה כללית על Maps JavaScript API
- זמינות אזורית: גלובלית. התכונות הזמינות (כמו מפות תלת-ממדיות, תנועה, מסלולים ועיצוב גבולות) משתנות בהתאם למדינה או לאזור. התנאים וההגבלות של האזור הכלכלי האירופי (EEA) חלים על כתובות לחיוב באזור הכלכלי האירופי. (פרטי הכיסוי)
Maps JavaScript API: מתי כדאי להשתמש בו
מתי כדאי להשתמש ב-Maps JavaScript API:
- אתם צריכים מפה אינטראקטיבית דו-ממדית או תלת-ממדית עם סמנים בהתאמה אישית, גרפיקה או שכבות נתונים בדף אינטרנט.
- אתם צריכים להציג מיקומים של נכסים בזמן אמת ומסלולי נסיעה מזרם הנתונים שלכם באמצעות סמנים מתקדמים וקווים פוליגוניים.
- אתם צריכים לשרטט גבולות וירטואליים (עיגולים, פוליגונים) ולבדוק אם הקואורדינטות נמצאות בתוכם בדפדפן.
- אתם צריכים חיפוש מקומות, השלמה אוטומטית או Place Details בצד הלקוח באפליקציית אינטרנט דרך ספריית המקומות.
מתי לא כדאי להשתמש ב-Maps JavaScript API:
- אתם צריכים להטמיע מפה של מיקום העסק או קישור למסלול הגעה בלי לכתוב קוד JavaScript בהתאמה אישית. במקומו, צריך להשתמש ב-Maps Embed API.
- אתם צריכים רק קישור שפותח את מפות Google עם מיקום, חיפוש או מסלול. במקום זאת, צריך להשתמש בכתובות URL של מפות Google.
- אתם צריכים מעקב אחרי צי רכבים של נסיעות שיתופיות או משלוחים מתוזמנים, שמשולב עם Driver SDK לנייד ואימות JWT לקצה העורפי. במקום זאת, צריך להשתמש ב-Fleet Engine Service.
Maps JavaScript API: הגדרה
- השירות שצריך להפעיל:
maps-backend.googleapis.com - אימות: מפתח API
- שיוך השימוש: מגדירים את המאפיין
internalUsageAttributionIds(ב-MapOptions, ב-MapElementוב-Map3DElement, או ברכיבים ובאפשרויות הבקשה של Places, Routes ו-Address Validation) כדי להוסיף מזהי שיוך של שימוש, שמציינים ל-Google באילו ספריות ודוגמאות אתם משתמשים. - תחילת העבודה: הגדרת Maps JavaScript API
- חומר עזר: חומר עזר בנושא Maps JavaScript API
- תמחור: שימוש וחיוב ב-Maps JavaScript API
- כללי מדיניות: כללי המדיניות של Maps JavaScript API
- נתוני גרסה: נתוני הגרסה של Maps JavaScript API
חבילות רשמיות של Maps JavaScript API:
- npm:
@googlemaps/js-api-loader - npm:
@types/google.maps - npm:
@googlemaps/markerclusterer
Maps JavaScript API: מוצרים קשורים
- בדרך כלל משתמשים בו עם: Places API (חדש)
Maps JavaScript API: טעויות נפוצות
- הבעיה: מפה כהה או תמונות Street View שליליות עם סימן מים כתמונה "למטרות פיתוח בלבד" מופיעה במקום שגיאה כשהגדרת מפתח ה-API או החיוב שגויה. תיקון: מפעילים את החיוב בפרויקט בענן, כוללים מפתח API תקין בכל בקשה ובודקים את קוד השגיאה הספציפי במסוף הדפדפן. מידע נוסף זמין בכתובת /maps/documentation/javascript/error-messages.
- הבעיה: שירותים קודמים כמו
PlacesService,DirectionsServiceו-DistanceMatrixServiceמחזירים את השגיאהLegacyApiNotActivatedMapErrorבפרויקטים חדשים שבהם ה-API הקודם לא מופעל. תיקון: משתמשים במקבילות החדשות (המחלקהPlace, המחלקהRoute, המחלקהRouteMatrix) שמגובות על ידי Places API (החדש) ו-Routes API. מידע נוסף זמין בכתובת /maps/legacy#LegacyApiNotActivatedMapError. - הבעיה: החל מגרסה 3.65, מפות לוויין ומפות היברידיות לא עוברות יותר לתמונות בזווית של 45 מעלות, ואין השפעה ל-
map.setTilt(45). הפתרון: משתמשים במפות תלת-ממדיות במקום בתמונות בזווית של 45 מעלות. אפשר לקרוא מידע נוסף בכתובת /maps/deprecations. - הבעיה: כדי להשתמש בסמנים מתקדמים צריך מזהה מפה. אי אפשר להשתמש ב-
AdvancedMarkerElementבמפות שנוצרו בלי מזהה מפה. תיקון: יוצרים מזהה מפה במסוף Cloud (או משתמשים ב-DEMO_MAP_IDלבדיקה) ומגדירים אתmapIdבמפה. מידע נוסף זמין בכתובת /maps/documentation/javascript/advanced-markers/start.
Maps JavaScript API: תכונות מדור קודם ותכונות שהוצאו משימוש
- Directions Service (
google.maps.DirectionsService): Legacy since 2025-03-01. החלפה: המחלקהRoute. הבעיה:LegacyApiNotActivatedMapErrorבפרויקטים שבהם לא מופעל Directions API הקודם. למדריך להעברת נתונים (מיגרציה) - שירות מטריצת מרחקים (
google.maps.DistanceMatrixService): מדור קודם החל מ-1 במרץ 2025. החלפה: המחלקהRouteMatrix. הבעיה:LegacyApiNotActivatedMapErrorבפרויקטים שבהם לא מופעלת הגרסה הקודמת של Distance Matrix API. למדריך להעברת נתונים (מיגרציה) - שירות Places (
google.maps.places.PlacesService): גרסה קודמת החל מ-1 במרץ 2025. החלפה: הכיתהPlace(Places API (חדש)). התופעה:LegacyApiNotActivatedMapErrorבפרויקטים שבהם לא מופעל Places API הקודם. למדריך להעברת נתונים (מיגרציה) google.maps.Marker: הוצא משימוש ב-22 בפברואר 2024. החלפה:google.maps.marker.AdvancedMarkerElement. תסמין: עדיין פועל ואין תוכניות להפסיק את השירות, אבל באגים קיימים לא יתוקנו. למדריך להעברת נתונים (מיגרציה)KmlLayer: הוצא משימוש ב-30 באפריל 2026. החלפה: סגנון מבוסס-נתונים לקבוצות נתונים, או מנתחי KML של צד שלישי עם שכבת הנתונים. התופעה:KmlLayerלא זמין בגרסה 3.66 ואילך. גרסה 3.65, הגרסה האחרונה שתומכת בו, תצא משימוש במאי 2027. למדריך להעברת נתונים (מיגרציה)- שכבת מפת חום (ספריית הוויזואליזציה): הוצאה משימוש החל מ-20 במאי 2026. החלפה: ספריות של צד שלישי כמו deck.gl
HeatmapLayer. תסמין: לא זמין החל ממאי 2026. למדריך להעברת נתונים (מיגרציה) - ספריית השרטוטים: הוצאה משימוש החל מ-4 ביוני 2026. החלופה: Terra Draw. תסמין: לא זמין החל ממאי 2026. למדריך להעברת נתונים (מיגרציה)
- תמונות בזווית של 45°: הוצאו משימוש החל מ-20 במאי 2026. החלופה: מפות בתלת-ממד. התופעה: הפונקציה
map.setTilt(45)לא פועלת, ותצוגת הלוויין נשארת מלמעלה למטה. למדריך להעברת נתונים (מיגרציה) google.maps.event.addDomListener()ו-addDomListenerOnce(): הוצאו משימוש ב-7 באפריל 2022. החלפה: DOM רגילaddEventListener().- האפשרויות
bounds,locationו-radiusבשירות ההשלמה האוטומטית למקומות: הוצאו משימוש ב-18 במאי 2023. החלפה:locationBiasו-locationRestriction. gmp-place-content-config(PlaceContentConfigElement) ב-Places UI Kit: הוצאה משימוש. החלפה: מוסיפים רכיבי תוכן ישירות לרכיבים של Place Details או בהגדרות של חיפוש מקומות.- ספריית ההקשר המקומי: הוצאה משימוש. החלפה: ספריית Places.
מה אפשר לעשות עם Maps JavaScript API
במדריכים שמקושרים בהמשך מפורטות כל המשימות, ואפשר גם להשוות בין המוצרים בסייר היכולות.
Maps JavaScript API: אימות כתובת
- החזרת כתובת מאומתת לכתובת או לכתובת חלקית שצוינה.
- החזרת הקואורדינטות של קו הרוחב/האורך של כתובת מאומתת.
- החזרת מזהה המקום ב-Google של כתובת מאומתת.
- שימוש באישור של מערכת התמיכה לדיוק קידוד (CASS) של שירות הדואר של ארצות הברית (USPS) לאימות כתובות.
- החזרת מידע על כתובת מאומתת: האם מדובר בעסק, בבית מגורים או בתא דואר.
- החזרת מטא-נתונים של שירות הדואר של ארצות הברית (USPS) לגבי כתובת מאומתת.
- החזרת ה-Plus Code של כתובת מאומתת.
Maps JavaScript API: סגנון מבוסס-נתונים לגבולות
- שינוי הסגנון של גבולות במפה.
- להגיב לאינטראקציות של משתמשים עם גבולות במפה.
- הוספת סגנון כורופלתי למפה.
Maps JavaScript API: סגנון מבוסס-נתונים לקבוצות נתונים
- יצירת מערך נתונים גיאו-מרחבי לשימוש חוזר בפלטפורמות שונות.
- הוספת מערך נתונים גיאו-מרחביים בהתאמה אישית למפה.
- לשנות את הסגנון של תכונות במערך נתונים מותאם אישית במפה.
- להגיב לאינטראקציות של משתמשים עם תכונות של מערכי נתונים מותאמים אישית במפה.
Maps JavaScript API: מערכי נתונים
- הוספת שכבת KML למפה הערה: ב-Maps JavaScript API, KmlLayer הוצא משימוש (הגרסה האחרונה שנתמכת היא 3.65, והוא יושבת במאי 2027). צריך לעבור לסגנון מבוסס-נתונים לגבולות או למערכי נתונים, או לטעון GeoJSON בשכבת הנתונים. שכבות KML עדיין נתמכות ב-Android וב-iOS דרך ספריות השירות של Maps SDK.
- הוספת שכבת GeoRSS למפה הערה: הוצא משימוש ב-Maps JavaScript API (התמיכה ב-KmlLayer תופסק בגרסה 3.65, במאי 2027). צריך להמיר פידים של GeoRSS ל-GeoJSON ולטעון אותם בשכבת הנתונים באמצעות map.data.addGeoJson().
- הוספת נתוני GeoJSON למפה.
Maps JavaScript API: מסלולים וניווט
- החזרת מסלול בין שתי קואורדינטות או יותר של קו רוחב/קו אורך כסדרה של קואורדינטות לכל שלב במסלול.
- החזרת מסלול בין שתי קבוצות או יותר של קואורדינטות קו רוחב/קו אורך כסדרה של תיאורי תמרונים לשלבים לאורך המסלול.
- החזרת המרחק בין כל שלב במסלול בין שתי קבוצות או יותר של קואורדינטות קו רוחב/קו אורך.
- החזרת זמן ההגעה בין כל שלב במסלול בין שתי קבוצות או יותר של קואורדינטות קו רוחב/קו אורך.
- החזרת קו פוליגוני מקודד בין כל שלב במסלול בין שתי קבוצות או יותר של קואורדינטות קו רוחב/קו אורך.
- החזרת המרחק של מסלול בין שתי קבוצות או יותר של קואורדינטות של קו רוחב/קו אורך.
- החזרת זמן ההגעה של מסלול בין שתי קבוצות או יותר של קואורדינטות קו רוחב/קו אורך.
- החזרת קו פוליגוני מקודד למסלול בין שתי קבוצות או יותר של קואורדינטות קו רוחב/קו אורך.
- מציינים את אמצעי התחבורה (נסיעה, תחבורה ציבורית, הליכה, רכב דו-גלגלי) לבקשת מסלול. הערה: בשירות האינטרנט של Routes API (computeRoutes), מעבירים את travelMode בגוף ה-JSON של HTTP POST באמצעות RouteTravelMode (DRIVE, BICYCLE, TWO_WHEELER, WALK, TRANSIT או TRUCK עם routeModifiers.vehicleInfo) וכוללים את הכותרת הנדרשת X-Goog-FieldMask במקום פרמטר שאילתה של מצב GET מדור קודם. בספריית המסלולים של Maps JavaScript API, מעבירים את travelMode ואת השדות ב-ComputeRoutesRequest.
- מציינים עצירה או נקודת מעבר לבקשת מסלול.
- מציינים איך להשתמש בנתוני התנועה בבקשה למסלול.
- מציינים מאפיינים שרוצים להימנע מהם, כמו כבישים מהירים או כבישי אגרה, בבקשה למסלול.
- מציינים מרחק קצר יותר או מסלול חלופי לבקשת מסלולים. הערה: ב-Routes API, בקשה למסלול חלופי קצר יותר (SHORTER_DISTANCE) היא תכונה ניסיונית, ובקשה למסלולים חלופיים (computeAlternativeRoutes) היא תכונה ב-GA.
- החזרת מרחקים למטריצה של מסלולים בין כמה נקודות מוצא ויעדים.
- החזרת זמני נסיעה למטריצה של מסלולים בין כמה נקודות מוצא ויעדים.
- מציינים את אמצעי התחבורה (נסיעה, תחבורה ציבורית, הליכה, רכב דו-גלגלי) לבקשה של מטריצת מסלולים. הערה: בשירות האינטרנט של Routes API (computeRouteMatrix), מעבירים את travelMode בגוף ה-JSON של HTTP POST באמצעות RouteTravelMode (DRIVE, TWO_WHEELER, WALK, TRANSIT או TRUCK עם origins[].routeModifiers.vehicleInfo; BICYCLE לא נתמך במטריצות מסלולים) וכוללים את הכותרת הנדרשת X-Goog-FieldMask. בספריית המסלולים של Maps JavaScript API, מעבירים את travelMode ואת השדות ב-ComputeRouteMatrixRequest.
Maps JavaScript API: גובה
- החזרת הגובה של קבוצת קואורדינטות של קו רוחב/קו אורך.
- החזרת ההפרש בגובה לאורך מסלול בין שתי קבוצות או יותר של קואורדינטות של קו רוחב/קו אורך.
Maps JavaScript API: Fleet Engine
- הוספת המיקום בזמן אמת של רכבי המשלוחים והמשימות של Fleet Engine למפה.
- הוספת המסלולים החזויים של רכבי המשלוחים והמשימות של Fleet Engine למפה.
- הוספת המיקום, העצירות, המשימות וסמני נקודות הציון של רכב משלוחים ב-Fleet Engine למפה.
- להגיב לאירועים של רכבי משלוחים ב-Fleet Engine, כולל נסיעות, מקטעים, משלוחים ומשימות שהושלמו.
- שינוי הסגנון של כבישים, קווים פוליגוניים ופוליגונים במפה למעקב אחרי צי רכב ב-Fleet Engine
- הצגה או הסתרה של מאפייני מפה במפה למעקב אחרי צי רכב ב-Fleet Engine
- שינוי הסגנון של הסמלים ותוויות הטקסט במפה למעקב אחרי צי רכב ב-Fleet Engine.
- להחיל סגנונות מפה שונים על רמות זום שונות במפה למעקב אחרי צי רכב ב-Fleet Engine.
- שינוי צפיפות המקומות במפה למעקב אחרי צי רכב ב-Fleet Engine ניסיוני הערה: התמיכה בעיצוב מפות מבוסס-ענן במפות למעקב אחרי צי הרכב של Fleet Engine זמינה לכולם, אבל השליטה בצפיפות של נקודות העניין היא תכונה ניסיונית של עיצוב מפות מבוסס-ענן (נתמכת רק בסגנונות מפה בהירים).
- שינוי הסגנון של מבנים במפה למעקב אחרי צי רכב ב-Fleet Engine. ניסיוני הערה: התמיכה בעיצוב מפות מבוסס-ענן במפות למעקב אחרי צי הרכב של Fleet Engine זמינה לכולם, אבל ההתאמה האישית של סגנון המבנים בתלת-ממד ושל סגנון השטח שהם תופסים היא תכונה ניסיונית של עיצוב מפות מבוסס-ענן (נתמכת רק בסגנונות של מפות בהירות).
- שינוי הסגנון של ציוני דרך במפה למעקב אחרי צי רכב ב-Fleet Engine. ניסיוני הערה: התמיכה בעיצוב מפות מבוסס-ענן במפות למעקב אחרי צי הרכב ב-Fleet Engine זמינה לכולם, אבל ההתאמה האישית של סמלי ציוני הדרך היא תכונה ניסיונית של עיצוב מפות מבוסס-ענן (נתמכת רק בסגנונות מפה בהירים).
- התאמה אישית של סמן במפה למעקב אחרי צי רכב ב-Fleet Engine
- התאמה אישית של הקו הפוליגוני של המסלול במפה למעקב אחרי צי הרכב ב-Fleet Engine.
Maps JavaScript API: המרת כתובות לקואורדינטות (geocoding)
- החזרת הקואורדינטות של קווי האורך והרוחב של כתובת (המרת כתובות לקואורדינטות).
- החזרת הכתובת של קבוצת קואורדינטות של קווי רוחב/אורך (המרת קואורדינטות לכתובות).
Maps JavaScript API: מפות
- הוספת מפה אינטראקטיבית שניתן להתאים אישית לדף אינטרנט או לאפליקציה לנייד. הערה: ב-Android: מגדירים את
ב-AndroidManifest.xmlשמגובה על ידי הפלאגין Secrets Gradle או אתmanifestPlaceholders["MAPS_API_KEY"]ב-app/build.gradle.kts. אף פעם אל תכתבו בתוך הקוד אתYOUR_GOOGLE_MAPS_API_KEYב-AndroidManifest.xml, ואף פעם אל תחליפו אתGoogleMap(או את maps-composeGoogleMap) ב-canvas מדומה אופליין או ב-Leaflet WebView אם מופיעE/Google Maps Android API: Authorization failure. יש להנחות את המשתמש לספק אתMAPS_API_KEYדרך Secrets ולהפעיל את SDK של מפות ל-Android (או את Navigation SDK כשמשתמשים ב-NavigationView או ב-SupportNavigationFragment). - יוצרים מזהה מפה שאפשר לעשות בו שימוש חוזר כדי לשמור את הגדרות העיצוב והתצורה של המפה.
- להגיב לאינטראקציות של משתמשים ולאירועים במפה.
- התאמה אישית של הפקדים שמופיעים במפה.
- שליטה בזום ובהזזה במפה (מצלמה).
- שינוי סוג המפה.
- שינוי ערכת הצבעים של המפה
- התאמה לשוק המקומי של מפה.
- הוספת שכבת תנועה למפה
- הוספת שכבת תחבורה ציבורית למפה
- הוספת שכבת רכיבה על אופניים למפה
Maps JavaScript API: הערות במפות
- הוספת חלון מידע למפה
- מוסיפים צורה או קו למפה.
- הוספת סמל וקטורי למפה.
- הוספת שכבות-על של deck.gl למפה.
- הוספת שכבת-על של תמונה שמעוגנת לפני השטח של המפה.
- הוספת שכבת-על של משבצות בהתאמה אישית למפה.
- הוספת סמן למפה. הערה: ערכת Navigation SDK ל-Android לא תומכת ב-AdvancedMarkerOptions. כשמשתמשים ב-Navigation SDK ל-Android, צריך להוסיף סמנים באמצעות GoogleMap.addMarker(MarkerOptions).
- התאמה אישית של סמן במפה הערה: ערכת Navigation SDK ל-Android לא תומכת ב-AdvancedMarkerOptions. כשמשתמשים ב-Navigation SDK ל-Android, צריך להתאים אישית את הסמנים באמצעות MarkerOptions.
- להגיב לאינטראקציות של משתמשים עם סמנים במפה.
- לבדוק אם קואורדינטה נמצאת בתוך פוליגון או אזור מעגלי במפה. הערה: ב-Android, משתמשים ב-PolyUtil.containsLocation ב-SDK של מפות ל-Android Utility Library לפוליגונים. באזורים מעגליים, בודקים אם המרחק הכדורי ממרכז המעגל נמצא בתוך הרדיוס (לדוגמה, computeDistanceBetween ב-Maps JavaScript API, SphericalUtil.computeDistanceBetween ב-Android או GMSGeometryDistance ב-iOS).
- חישוב מרחק, שטח או כיוון כדוריים בין קואורדינטות במפה.
Maps JavaScript API: סגנון המפה
- יצירת סגנון מפה לשימוש חוזר בפלטפורמות שונות.
- שינוי הסגנון של כבישים, קווים פוליגוניים ופוליגונים במפה.
- הצגה או הסתרה של תכונות במפה.
- לשנות את הסגנון של הסמלים ותוויות הטקסט במפה.
- להחיל סגנונות מפה שונים על רמות זום שונות.
- לשנות את צפיפות המקומות במפה. ניסיוני
- לשנות את הסגנון של מבנים במפה. ניסיוני
- שינוי הסגנון של ציוני דרך במפה. ניסיוני
Maps JavaScript API: אחר
Maps JavaScript API: מפות תלת-ממדיות פוטו-ריאליסטיות
- הוספת מפה תלת-ממדית אינטראקטיבית ופוטו-ריאליסטית לדף אינטרנט.
- הוספת סמן למפה תלת-ממדית פוטו-ריאליסטית
- התאמה אישית של סמן במפה תלת-ממדית פוטו-ריאליסטית.
- הוספת מודל תלת-ממדי למפה תלת-ממדית פוטו-ריאליסטית.
- הוספת שכבת-על למפה תלת-ממדית פוטו-ריאליסטית.
- הוספת קו פוליגוני תלת-ממדי למפה תלת-ממדית פוטו-ריאליסטית.
- הוספת פוליגון תלת-ממדי למפה תלת-ממדית פוטו-ריאליסטית.
- להגיב לאינטראקציות ולאירועים של משתמשים במפה תלת-ממדית פוטו-ריאליסטית.
- התאמה אישית של אמצעי הבקרה שמופיעים במפה תלת-ממדית פוטו-ריאליסטית.
- שליטה בנתיב המצלמה ובאנימציות במפה תלת-ממדית פוטו-ריאליסטית.
- שליטה בהגבלות על המצלמה במפה תלת-ממדית פוטו-ריאליסטית.
Maps JavaScript API: מקומות
- החזרת רשימה של מקומות ו-Place Details על סמך מחרוזת שאילתה.
- החזרת רשימה של מקומות ופרטי מקומות ליד מיקום ספציפי.
- החזרת תוצאות של השלמה אוטומטית לגבי מקומות על סמך מחרוזת שאילתה.
- החזרת מידע מפורט על מקום ספציפי.
- להציג תמונות של מקום ספציפי. הערה: צריך להציג לצד כל תמונה את השיוך ליוצר (שם היוצר, עם קישור ל-URI של הפרופיל שלו). הדרישה הזו מופיעה במדיניות של כל פלטפורמה בנושא מקומות, למשל: /maps/documentation/javascript/policies#photo-attributions וגם /maps/documentation/places/web-service/policies#photos-and-review.
- שינוי הגודל של תמונות המקומות.
- הצגת דירוגים וביקורות של מקום ספציפי. הערה: בשירות האינטרנט של Places API (חדש), פרטי המקום הם בקשת GET אל https://places.googleapis.com/v1/places/{placeId} עם X-Goog-FieldMask (לדוגמה, rating,userRatingCount,reviews). חיפוש טקסט, חיפוש בסביבה והשלמה אוטומטית משתמשים ב-POST. ב-Android, מעבירים את Place.Field.RATING, USER_RATING_COUNT ו-REVIEWS אל PlacesClient.fetchPlace(). ב-iOS, מעבירים את GMSPlacePropertyRating, GMSPlacePropertyUserRatingsTotal ו-GMSPlacePropertyReviews ב-GMSFetchPlaceRequest.
- הוספת ווידג'ט של השלמה אוטומטית לדף אינטרנט או לאפליקציה שמחזיר תוצאות לגבי מקומות על סמך מחרוזת שאילתה.
- מציינים את שדות הנתונים שייכללו בתגובות עם מידע על מקומות.
- מציינים את סוגי המקומות שרוצים לכלול בתשובות עם מידע על מקומות.
Maps JavaScript API: Places UI Kit
- הוספת רכיב בממשק המשתמש שמציג סיכומים וביקורות מבוססי-AI על מקומות ספציפיים בדף אינטרנט או באפליקציה לנייד. הערה: התכונה נתמכת באינטרנט בלבד (Places UI Kit של Maps JavaScript API). ערכות Places UI Kit לנייד לא כוללות רכיב של סיכום AI. דרישת תאימות באזור הכלכלי האירופי (EEA): כדי להציג נתוני מקומות במפה באזור הכלכלי האירופי (EEA), צריך להשתמש ברכיבים של Places UI Kit בצד הלקוח ב-Maps JavaScript API, במקום לשלוח קריאות לשירותי האינטרנט של Places API משרת בק-אנד. הדרישות המלאות ושאלות נפוצות: https://developers.google.com/maps/comms/eea/faq
- להחיל סגנון CSS על רכיב בממשק המשתמש של נתוני המקום. הערה: מאפייני CSS מותאמים אישית חלים על רכיבים של Places UI Kit ב-Maps JavaScript API. ב-Places SDK ל-Android וב-Places SDK ל-iOS, העיצוב של תצוגות Places UI Kit נקבע באופן פרוגרמטי באמצעות מאפייני עיצוב וסגנון. דרישת תאימות באזור הכלכלי האירופי (EEA): כדי להציג נתוני מקומות במפה באזור הכלכלי האירופי (EEA), אל תפעילו שירותי אינטרנט של Places API משרת בק-אנד. משתמשים ברכיבים של Places UI Kit בצד הלקוח בפלטפורמת היעד (Maps JavaScript API באינטרנט, Places SDK ל-Android ב-Android או Places SDK ל-iOS ב-iOS). הדרישות המלאות ושאלות נפוצות: https://developers.google.com/maps/comms/eea/faq
- התאמה אישית של העיצוב וההגדרות של רכיבים בממשק המשתמש של נתוני המקומות באמצעות כלי להתאמה אישית של רכיבים בממשק המשתמש. הערה: דרישת תאימות באזור הכלכלי האירופי (EEA): כדי להציג נתוני מקומות במפה באזור הכלכלי האירופי (EEA), אל תשלחו קריאות לשירותי האינטרנט של Places API משרת בק-אנד. משתמשים ברכיבים של Places UI Kit בצד הלקוח בפלטפורמת היעד (Maps JavaScript API באינטרנט, Places SDK ל-Android ב-Android או Places SDK ל-iOS ב-iOS). הדרישות המלאות ושאלות נפוצות: https://developers.google.com/maps/comms/eea/faq
- הוספת רכיב בממשק המשתמש שמציג מידע על מקום ספציפי בדף אינטרנט או באפליקציה לנייד. הערה: דרישת תאימות באזור הכלכלי האירופי (EEA): כדי להציג נתוני מקומות במפה באזור הכלכלי האירופי (EEA), אין להפעיל את שירותי האינטרנט של Places API משרת בק-אנד. משתמשים ברכיבים של Places UI Kit בצד הלקוח בפלטפורמת היעד (Maps JavaScript API באינטרנט, Places SDK ל-Android ב-Android או Places SDK ל-iOS ב-iOS). הדרישות המלאות ושאלות נפוצות: https://developers.google.com/maps/comms/eea/faq
- הוספת רכיב בממשק המשתמש שמציג רשימה של מקומות על סמך מחרוזת שאילתה לדף אינטרנט. הערה: יש תמיכה גם בדפי אינטרנט (Maps JavaScript API) וגם באפליקציות לנייד (Places SDK ל-Android ו-Places SDK ל-iOS). דרישת תאימות באזור הכלכלי האירופי (EEA): כדי להציג נתוני מקומות במפה באזור הכלכלי האירופי (EEA), אל תפעילו שירותי אינטרנט של Places API משרת בק-אנד. משתמשים ברכיבים של Places UI Kit בצד הלקוח בפלטפורמת היעד (Maps JavaScript API באינטרנט, Places SDK ל-Android ב-Android או Places SDK ל-iOS ב-iOS). הדרישות המלאות ושאלות נפוצות: https://developers.google.com/maps/comms/eea/faq
- הוספת רכיב בממשק המשתמש שמציג רשימה של מקומות ליד מיקום ספציפי בדף אינטרנט. הערה: יש תמיכה גם בדפי אינטרנט (Maps JavaScript API) וגם באפליקציות לנייד (Places SDK ל-Android ו-Places SDK ל-iOS). דרישת תאימות באזור הכלכלי האירופי (EEA): כדי להציג נתוני מקומות במפה באזור הכלכלי האירופי (EEA), אל תפעילו שירותי אינטרנט של Places API משרת בק-אנד. משתמשים ברכיבים של Places UI Kit בצד הלקוח בפלטפורמת היעד (Maps JavaScript API באינטרנט, Places SDK ל-Android ב-Android או Places SDK ל-iOS ב-iOS). הדרישות המלאות ושאלות נפוצות: https://developers.google.com/maps/comms/eea/faq
- הוספת רכיב בסיסי של השלמה אוטומטית בממשק המשתמש לדף אינטרנט או לאפליקציה, שמחזיר מזהי מקומות ב-Google על סמך מחרוזת שאילתה. הערה: דרישת תאימות באזור הכלכלי האירופי (EEA): כדי להציג נתוני מקומות במפה באזור הכלכלי האירופי (EEA), אל תשלחו קריאות לשירותי האינטרנט של Places API משרת בק-אנד. משתמשים ברכיבים של Places UI Kit בצד הלקוח בפלטפורמת היעד (Maps JavaScript API באינטרנט, Places SDK ל-Android ב-Android או Places SDK ל-iOS ב-iOS). הדרישות המלאות ושאלות נפוצות: https://developers.google.com/maps/comms/eea/faq
Maps JavaScript API: Street View
- הוספת תצוגת Google Street View אינטראקטיבית וניתנת להגדרה לדף אינטרנט או לאפליקציה לנייד.
- הוספת סמן או שכבת-על ל-Google Street View.
- להגיב לאינטראקציות ולאירועים של משתמשים ב-Google Street View.
- התאמה אישית של הפקדים שמופיעים ב-Google Street View.
- החזרת תמונה פנורמית של Google Street View למיקום ספציפי.