קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. ב-Cloud Console, נכנסים לדף ניהול המפות.
  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'
});

סטטי של מפות Google

כדי להוסיף מזהה מפה למפה חדשה או קיימת שמשתמשת באחד מממשקי ה-API של שירותי האינטרנט שלנו, מוסיפים את הפרמטר map_id של כתובת ה-URL ומגדירים אותו למזהה המפה. בדוגמה זו ניתן להוסיף מזהה מפה למפה באמצעות 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" />

מפה שבמרכזה נמצא גשר ברוקלין בניו יורק, ארה&quot;ב, עם פקדי המפה בפינה השמאלית התחתונה. המפה מציגה עיצוב מותאם אישית בדרכים, במים וביבשה.

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

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

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

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