שימוש במזהי מפה

תכונה בתשלום: הפונקציונליות שאליה ניתן לגשת על ידי הוספת מזהה מפה גורמת לטעינת מפה עם טעינת המק"ט הדינמי של מפות Google ל-Android ול-iOS. אפשר לקרוא מידע נוסף במאמר חיוב במפות Google.

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

לאחר היצירה של מזהי המפה, הם משויכים לפרויקט מסוים והם מוגבלים לפלטפורמה אחת (Android , iOS או JavaScript) או ל-API של מפות סטטיות של מפות Google.

כדי ליצור או לנהל מזהי מפה ב-Cloud Console, צריך להיות לכם תפקיד IAM או Project Manager.

ההרשאות הנדרשות

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

יצירת מזהה מפה

מזהה מפה הוא מזהה ייחודי שמייצג מופע יחיד של מפת Google. תוכלו ליצור מזהי מפה ולעדכן סגנון שמשויך למזהה המפה ב-Cloud Console בכל שלב.

כדי ליצור מזהה מפה:

1. במסוף Cloud, נכנסים אל דף ניהול המפות.
2. בוחרים באפשרות יצירת מזהה מפה חדש כדי להציג את הטופס יצירת מזהה מפה חדש.
   
   

   בטופס, מבצעים את הפעולות הבאות:

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

שיוך מזהה מפה לסגנון מפה

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

1. במסוף Cloud, נכנסים אל דף ניהול המפות.
2. בדף הזה, בוחרים מזהה מפה קיים בעמודה שם המפה.
3. בחלק התחתון של הטופס, בוחרים סגנון מפה מהתפריט הנפתח סגנונות המפה המשויכים למזהה המפה הזה.
4. לוחצים על שמירה.
   

הוספת מזהה המפה לאפליקציה שלך

Android

מוסיפים את מזהה המפה דרך אלמנט <fragment> בקובץ הפריסה של הפעילות, באמצעות המחלקה MapView או באמצעות תכנות, באמצעות מחלקה GoogleMapOptions.

לדוגמה, נניח שיצרתם מזהה מפה ששמור בתור ערך מחרוזת בשם map_id ב-res/values/strings.xml:

<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="map_id">YOUR_MAP_ID</string>
</resources>

לגבי מפות שנוספו באמצעות רכיב <fragment> בקובץ הפריסה של הפעילות, לכל מקטעי המפה שאמורים להיות בסגנון המותאם אישית חייבים לציין את מזהה המפה במאפיין map:mapId:

<fragment xmlns:map="http://schemas.android.com/apk/res-auto"
    class="com.google.android.gms.maps.SupportMapFragment"
    …
    map:mapId="@string/map_id" />

בנוסף, ניתן להשתמש במאפיין map:mapId של המחלקה MapView כדי לציין מזהה מפה:

<com.google.android.gms.maps.MapView
    xmlns:android="http://schemas.android.com/apk/res/android"
    ....
    map:mapId="@string/map_id" />

כדי לציין מזהה מפה באופן פרוגרמטי, צריך להעביר אותו למופע MapFragment באמצעות המחלקה GoogleMapOptions:

Java

 MapFragment mapFragment = MapFragment.newInstance(
     new GoogleMapOptions()
         .mapId(getResources().getString(R.string.map_id)));

Kotlin

 val mapFragment = MapFragment.newInstance(
     GoogleMapOptions()
         .mapId(resources.getString(R.string.map_id))
 )

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

iOS

כדי ליצור מפה באמצעות מזהה מפה, מבצעים את הרשימה הבאה:

1. יוצרים GMSMapID באמצעות מחרוזת מזהה המפה מ-Cloud Console.
2. יש ליצור GMSMapView ולציין את מזהה המפה שיצרת עכשיו.

Swift

let camera = GMSCameraPosition(latitude: 47.0169, longitude: -122.336471, zoom: 12)
let mapID = GMSMapID(identifier: "<YOUR MAP ID>")
let mapView = GMSMapView(frame: .zero, mapID: mapID, camera: camera)
self.view = mapView

Objective-C

GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:47.0169
                                                        longitude:-122.336471
                                                             zoom:12];
GMSMapID *mapID = [GMSMapID mapIDWithIdentifier:@"<YOUR MAP ID>"];
GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero mapID:mapID camera:camera];
self.view = mapView;

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

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

JavaScript

כדי ליצור מפה עם מזהה מפה בקוד האפליקציה:

1. אם אתם מתאימים אישית את המפה באמצעות קוד JSON מוטמע, יש להסיר את המאפיין styles מהאובייקט MapOptions. אחרת, מדלגים על השלב הזה.

2. מוסיפים למפה מזהה של מפה באמצעות המאפיין mapId. לדוגמה:

map = new google.maps.Map(document.getElementById('map'), {
center: {lat: -34.397, lng: 150.644},
zoom: 8,
mapId: 'MAP_ID'
});

סטטי מפות

כדי להוסיף מזהה מפה למפה חדשה או קיימת שמשתמשת באחד מממשקי ה-API של שירות האינטרנט שלנו, מוסיפים את הפרמטר של כתובת ה-URL של map_id ומגדירים אותו למזהה המפה. דוגמה זו מציגה הוספת מזהה מפה למפה באמצעות Maps Static API.

<img src="https://maps.googleapis.com/maps/api/staticmap?center=Brooklyn+Bridge,New+York,NY&zoom=13&size=600x300&maptype=roadmap&markers=color:blue%7Clabel:S%7C40.702147,-74.015794&markers=color:green%7Clabel:G%7C40.711614,-74.012318&markers=color:red%7Clabel:C%7C40.718217,-73.998284&key=YOUR_API_KEY&map_id=YOUR_MAP_ID&signature=YOUR_SIGNATURE" />

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

התכונות שזמינות לשימוש במזהי המפה

עיצוב מפות מבוסס-ענן: עיצוב, התאמה אישית וניהול של המפות באמצעות מסוף Google Cloud.
זמין בכל הפלטפורמות (Android , JavaScript , iOS ו-Maps Static API)

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