שימוש במזהי מפות
מזהה מפה הוא מזהה שמשויך לסגנון מפה או לתכונה מסוימת. צריך להגדיר סגנון מפה ולשייך אותו למזהה מפה במסוף Google Cloud. לאחר מכן, כשמציינים מזהה מפה בקוד, סגנון המפה שמשויך אליו מוצג באפליקציה. כל עדכוני הסגנון הבאים שיבוצעו באפליקציה יופיעו באופן אוטומטי, בלי שהלקוחות יצטרכו לבצע עדכונים.
בזמן היצירה, מזהי המפות משויכים לפרויקט, והם מוגבלים גם לפלטפורמה אחת (Android, iOS, JavaScript) או ל-API הסטטי של מפות Google.
כדי ליצור או לנהל מזהי מפות במסוף Cloud, צריך להיות לכם תפקיד IAM של 'בעלי הפרויקט' או 'עורך פרויקט'.
ההרשאות הנדרשות
כדי ליצור או לנהל מזהי מפות או סגנונות מפות בפרויקט נתון ב-Google Cloud, צריך להיות בתפקיד הזה בתפקיד 'בעלים' או 'עריכה' בפרויקט.
יצירת מזהה מפה
מזהה מפה הוא מזהה ייחודי שמייצג מופע יחיד של מפת Google. במסוף Cloud תוכלו ליצור מזהי מפות ולעדכן סגנון שמשויך למזהה המפה בכל שלב.
כדי ליצור מזהה מפה:
- נכנסים לדף ניהול מפות Google במסוף Cloud.
- בוחרים באפשרות Create New Map ID כדי להציג את הטופס Create New Map ID.
מבצעים את הפעולות הבאות בטופס:
- יש לציין שם למפה.
- מציינים סוג מפה או פלטפורמה.
- למפות JavaScript, בוחרים בסוג המפה 'רסטר' או 'מפה וקטורית'.
- מזינים תיאור של המפה.
- בוחרים באפשרות הבא כדי להציג את מזהה המפה החדש.
שיוך מזהה מפה לסגנון מפה
ההנחיות האלה מבוססות על ההנחה שיש לפחות סגנון מפה אחד בפרויקט.
- נכנסים לדף ניהול מפות Google במסוף Cloud.
- בדף הזה בוחרים מזהה מפה קיים מהעמודה שם המפה.
- בחלק התחתון של הטופס, בוחרים סגנון מפה מהתפריט הנפתח סגנונות מפה המשויכים למזהה המפה הזה.
- לוחצים על שמירה.
צריך להוסיף את מזהה המפה לאפליקציה
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
כדי ליצור מפה באמצעות מזהה מפה:
- יוצרים
GMSMapID
עם המחרוזת של מזהה המפה ממסוף Cloud. - יוצרים
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 מתי שתרצו ולהציג סגנון חדש במפה באופן אוטומטי עבורכם ולמשתמשים תוך כ-6 שעות.
אם רוצים לראות את השינויים באופן מיידי, אפשר לסגור את האפליקציה ולהפעיל אותה מחדש: לצאת מהאפליקציה, לאלץ יציאה מהאפליקציה מרשימת האפליקציות שהיו בשימוש לאחרונה ולאחר מכן לפתוח אותה מחדש. המפה המעודכנת תהיה גלויה.
JavaScript
כדי ליצור מפה עם מזהה מפה בקוד האפליקציה:
אם אתם מבצעים כרגע התאמה אישית של המפה באמצעות קוד JSON מוטמע, מסירים את הנכס
styles
מהאובייקטMapOptions
. אחרת, מדלגים על השלב הזה.אפשר להוסיף מזהה מפה למפה באמצעות המאפיין
mapId
. למשל:
map = new google.maps.Map(document.getElementById('map'), { center: {lat: -34.397, lng: 150.644}, zoom: 8, mapId: 'MAP_ID' });
סטטי של מפות
כדי להוסיף מזהה מפה למפה חדשה או קיימת שמשתמשת באחד מממשקי ה-API של שירות האינטרנט שלנו, צריך לצרף את הפרמטר map_id
של כתובת האתר ולהגדיר אותו למזהה המפה שלכם.
בדוגמה הזו ניתן לראות הוספה של מזהה מפה למפה באמצעות API 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" />
התכונות הזמינות כשמשתמשים במזהי מפות
עיצוב מפות מבוסס-ענן: עיצוב, התאמה אישית וניהול של המפות באמצעות מסוף Google Cloud.
זמין בכל הפלטפורמות (Android, JavaScript, iOS וה-API הסטטי של מפות Google)
מפות וקטוריות: מפה שמורכבת ממשבצות מבוססות וקטורים, המצוירת בזמן הטעינה בצד הלקוח באמצעות WebGL.
זמין ב-JavaScript