Importowanie danych GeoJSON do Map

Omówienie

Dowiedz się, jak importować dane GeoJSON z źródła lokalnego lub zdalnego i wyświetlać je na mapie. W tym samouczku na przykładzie mapy poniżej pokazujemy różne techniki importowania danych do map.

W sekcji poniżej znajdziesz cały kod potrzebny do utworzenia mapy w tym samouczku.

TypeScript

let map: google.maps.Map;

function initMap(): void {
  map = new google.maps.Map(document.getElementById("map") as HTMLElement, {
    zoom: 2,
    center: new google.maps.LatLng(2.8, -187.3),
    mapTypeId: "terrain",
  });

  // Create a <script> tag and set the USGS URL as the source.
  const script = document.createElement("script");

  // This example uses a local copy of the GeoJSON stored at
  // http://earthquake.usgs.gov/earthquakes/feed/v1.0/summary/2.5_week.geojsonp
  script.src =
    "https://developers.google.com/maps/documentation/javascript/examples/json/earthquake_GeoJSONP.js";
  document.getElementsByTagName("head")[0].appendChild(script);
}

// Loop through the results array and place a marker for each
// set of coordinates.
const eqfeed_callback = function (results: any) {
  for (let i = 0; i < results.features.length; i++) {
    const coords = results.features[i].geometry.coordinates;
    const latLng = new google.maps.LatLng(coords[1], coords[0]);

    new google.maps.Marker({
      position: latLng,
      map: map,
    });
  }
};

declare global {
  interface Window {
    initMap: () => void;
    eqfeed_callback: (results: any) => void;
  }
}
window.initMap = initMap;
window.eqfeed_callback = eqfeed_callback;
index.ts

JavaScript

let map;

function initMap() {
  map = new google.maps.Map(document.getElementById("map"), {
    zoom: 2,
    center: new google.maps.LatLng(2.8, -187.3),
    mapTypeId: "terrain",
  });

  // Create a <script> tag and set the USGS URL as the source.
  const script = document.createElement("script");

  // This example uses a local copy of the GeoJSON stored at
  // http://earthquake.usgs.gov/earthquakes/feed/v1.0/summary/2.5_week.geojsonp
  script.src =
    "https://developers.google.com/maps/documentation/javascript/examples/json/earthquake_GeoJSONP.js";
  document.getElementsByTagName("head")[0].appendChild(script);
}

// Loop through the results array and place a marker for each
// set of coordinates.
const eqfeed_callback = function (results) {
  for (let i = 0; i < results.features.length; i++) {
    const coords = results.features[i].geometry.coordinates;
    const latLng = new google.maps.LatLng(coords[1], coords[0]);

    new google.maps.Marker({
      position: latLng,
      map: map,
    });
  }
};

window.initMap = initMap;
window.eqfeed_callback = eqfeed_callback;
index.js

CSS

/* 
 * Always set the map height explicitly to define the size of the div element
 * that contains the map. 
 */
#map {
  height: 100%;
}

/* 
 * Optional: Makes the sample page fill the window. 
 */
html,
body {
  height: 100%;
  margin: 0;
  padding: 0;
}

style.css

HTML

<html>
  <head>
    <title>Earthquake Markers</title>

    <link rel="stylesheet" type="text/css" href="./style.css" />
    <script type="module" src="./index.js"></script>
  </head>
  <body>
    <div id="map"></div>

    <!-- 
      The `defer` attribute causes the script to execute after the full HTML
      document has been parsed. For non-blocking uses, avoiding race conditions,
      and consistent behavior across browsers, consider loading using Promises. See
      https://developers.google.com/maps/documentation/javascript/load-maps-js-api
      for more information.
      -->
    <script
      src="https://maps.googleapis.com/maps/api/js?key=AIzaSyB41DRUbKWJHPxaFjMAwdrzWzbVKartNGg&callback=initMap&v=weekly"
      defer
    ></script>
  </body>
</html>
index.html

Wypróbuj próbkę

Wczytuję dane

W tej sekcji dowiesz się, jak wczytywać dane z tej samej domeny co aplikacja Maps JavaScript API lub z innej domeny.

Wczytywanie danych z tej samej domeny

Warstwa danych Google Maps udostępnia kontener na dowolne dane geoprzestrzenne (w tym GeoJSON). Jeśli dane znajdują się w pliku hostowanym w tej samej domenie co aplikacja interfejsu Maps JavaScript API, możesz je wczytać za pomocą metody map.data.loadGeoJson(). Plik musi znajdować się w tej samej domenie, ale możesz go hostować w innej subdomenie. Możesz na przykład wysłać żądanie do files.example.com z www.example.com.

map.data.loadGeoJson('data.json');

Wczytywanie danych w różnych domenach

Możesz też poprosić o dane z domeny innej niż Twoja, jeśli konfiguracja tej domeny zezwala na takie żądanie. Standardem dla tego uprawnienia jest współdzielenie zasobów pomiędzy serwerami z różnych domen (CORS). Jeśli domena zezwala na żądania w wielu domenach, jej nagłówek odpowiedzi powinien zawierać tę deklarację:

Access-Control-Allow-Origin: *

Aby sprawdzić, czy w domenie włączono CORS, użyj Narzędzi dla programistów w Chrome (DevTools).

Wczytywanie danych z takiej domeny jest takie samo jak wczytywanie pliku JSON z tej samej domeny:

map.data.loadGeoJson('http://www.CORS-ENABLED-SITE.com/data.json');

Wysyłanie żądania JSONP

Aby móc korzystać z tej techniki, musisz mieć pewność, że domena docelowa obsługuje żądania JSONP.

Aby poprosić o dane w formacie JSONP, użyj elementu createElement(), aby dodać do nagłówka dokumentu tag script.

var script = document.createElement('script');
script.src = 'http://earthquake.usgs.gov/earthquakes/feed/v1.0/summary/2.5_week.geojsonp';
document.getElementsByTagName('head')[0].appendChild(script);

Gdy skrypt jest uruchamiany, domena docelowa przekazuje dane jako argument do innego skryptu, zwykle o nazwie callback(). Domena docelowa definiuje nazwę skryptu wywołania zwrotnego, która jest pierwszą nazwą na stronie podczas wczytywania adresu docelowego URL w przeglądarce.

Na przykład otwórz adres http://earthquake.usgs.gov/earthquakes/feed/v1.0/summary/2.5_week.geojsonp w oknie przeglądarki, aby sprawdzić, czy nazwa funkcji wywołania zwrotnego to eqfeed_callback.

Musisz zdefiniować skrypt wywołania zwrotnego w kodzie:

function eqfeed_callback(response) {
  map.data.addGeoJson(response);
}

Aby umieścić na mapie przeanalizowane dane GeoJSON, użyj metody addGeoJson().

Nadawanie stylów danym

Możesz zmienić wygląd danych, dodając dane GeoJSON do obiektu mapy. Więcej informacji o stylowaniu danych znajdziesz w przewodniku dla deweloperów.

Więcej informacji

  • GeoJSON to powszechnie używany otwarty format do kodowania danych geograficznych oparty na formacie JSON (JavaScript Object Notation). Narzędzia i metody JavaScripta przeznaczone do obsługi danych w formacie JSON działają też w przypadku GeoJSON. Aby dowiedzieć się więcej, przeczytaj przewodnik dla programistów.
  • JSONP to skrót od padded JSON. Jest to metoda komunikacji używana w programach JavaScript, które działają w przeglądarkach, do żądania danych z serwera w innej domenie.