‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

איך יוצרים מזהי מפה

בחירת פלטפורמה: Android Android 3D iOS iOS 3D JavaScript Web Service

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

לפרטים נוספים ולתכונות שמשתמשות במזהי מפות, קראו את הסקירה הכללית על מזהי מפות.

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

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

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

כדי ליצור מזהי מפות במסוף Cloud:

נכנסים לפרויקט במסוף Cloud ופותחים אותו עם ההרשאות הנדרשות.
במסוף Cloud, נכנסים לדף Maps Management.
לוחצים על יצירת מזהה מפה.
בדף Create new map ID, מבצעים את הפעולות הבאות:
1. בשדה שם, נותנים שם למזהה המפה.
2. אופציונלי: בשדה תיאור, מתארים את השימוש במזהה המפה.
3. בקטע סוג המפה, בוחרים את הפלטפורמה שבה רוצים להשתמש במזהה המפה. אם בוחרים ב-JavaScript, צריך לבחור גם סוג מפה: רסטר (ברירת המחדל) או וקטור. מידע נוסף על מפות וקטוריות זמין במאמר בנושא מפות וקטוריות.
4. לוחצים על שמירה כדי להציג את מזהה המפה החדש.

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

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

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

Android

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

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

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

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

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

אפשר גם להשתמש במאפיין map:mapId של המחלקה MapView כדי לציין מזהה מפה:

<com.google.android.gms.maps.MapView
    xmlns:map="http://schemas.android.com/apk/res-auto"
    ....
    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, מפתחים ומריצים את האפליקציה כרגיל. הסגנונות המותאמים אישית שהוגדרו בשלב הראשון יחולו על כל המפות עם מזהה המפה שצוין.

Android 3D

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

הוספת מזהה מפה, יצירת המפה באופן פרוגרמטי:

import com.google.android.gms.maps3d.GoogleMap3D
import com.google.android.gms.maps3d.Map3DOptions
import com.google.android.gms.maps3d.Map3DView
import com.google.android.gms.maps3d.OnMap3DViewReadyCallback
import com.google.android.gms.maps3d.model.Map3DMode

class MainActivity : Activity(), OnMap3DViewReadyCallback {
  fun onCreate(...) {
    val map3DOptions = Map3DOptions(mapMode = Map3DMode.HYBRID, mapId = "MAP_ID")
    val map3DView = Map3DView(context, map3DOptions)
    map3DView.getMap3dViewAsync(this)
  }
}

מוסיפים מזהה מפה באמצעות מאפייני פריסה:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
   xmlns:android="http://schemas.android.com/apk/res/android"
   xmlns:map3d="http://schemas.android.com/apk/res-auto"
   android:layout_width="match_parent" android:layout_height="match_parent">
 <com.google.android.gms.maps3d.Map3DView
     android:id="@+id/map3dView"
     android:layout_width="fill_parent"
     android:layout_height="fill_parent"
     map3d:mode="hybrid"
     map3d:mapId="MAP_ID"/>
</LinearLayout>

iOS

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

יוצרים GMSMapID עם מחרוזת מזהה המפה ממסוף Cloud.
יוצרים GMSMapView ומציינים את מזהה המפה שיצרתם.

Swift

let camera = GMSCameraPosition(latitude: 47.0169, longitude: -122.336471, zoom: 12)
let mapID = GMSMapID(identifier: "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:@"MAP_ID"];
GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero mapID:mapID camera:camera];
self.view = mapView;

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

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

iOS 3D

מפתחים ל-iOS יכולים להגדיר משתנה style חדש ב-Map. העיבוד הזה מקבל מזהה מפה, ואפשר להוסיף לו סגירה (closure) שתופעל אם מזהה המפה לא תקין או לא נמצא.

import SwiftUI
import GoogleMaps3D

struct ContentView: View {
  init () {
    Map.apiKey = "YOUR_API_KEY"
  }
  var body: some View {
    Map(initialCamera: .init(
        latitude: 0.0,
        longitude: 0.0,
      ),
      mode: .hybrid
    )
    .style(
      with: "MAP_ID",
      error: {
        // Handle styling error.
      }
    )
    // Could also use trailing closure syntax
    //  .style(with: "MAP_ID") {
    //     // Handle styling error.
    //  }
  }
}

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'
});

‫JavaScript בתלת-ממד

כדי ליצור מפה עם מזהה מפה באפליקציה, מוסיפים מזהה מפה למפה באמצעות המאפיין mapId. לדוגמה:

async function init() {
    const { Map3DElement } = await google.maps.importLibrary('maps3d');

    const map = new Map3DElement({
        center: {
            lat: 37.75183154601466,
            lng: -119.52369070507672,
            altitude: 2200,
        },
        tilt: 67.5,
        heading: 108.94057782079429,
        range: 6605.57279990986,
        mapId: 'bcce776b92de1336e22c569f', // Styles are associated with map IDs.
        mode: 'HYBRID',
    });

    document.body.append(map);
}

void init();index.js

Maps Static

כדי להוסיף מזהה מפה למפה חדשה או קיימת שמשתמשת באחד מממשקי ה-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=MAP_ID&signature=YOUR_SIGNATURE" />

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

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