/react-here-maps

React components and examples for HERE Maps API for JavaScript.

Primary LanguageTypeScript

React HERE Maps

This package provides React hooks, components and examples for HERE Maps API for JavaScript.

image

Demo: https://react-here-maps.vercel.app/

Installation

First, you need to include the HERE Maps API for JavaScript CSS in your HTML file.

<!DOCTYPE html>
<html lang="en">
  <head>
    <link rel="stylesheet" type="text/css" href="https://js.api.here.com/v3/3.1/mapsjs-ui.css" />
  </head>
  <body>
    ...
  </body>
</html>
# After that, install the HERE Maps API for JavaScript with your favorite package manager
npm install --save-dev @here/maps-api-for-javascript --registry=https://repo.platform.here.com/artifactory/api/npm/maps-api-for-javascript/
# Then install @rodrito/react-here-maps with your favorite package manager
npm install @rodrito/react-here-maps

# or
yarn add @rodrito/react-here-maps

# or
pnpm add @rodrito/react-here-maps

Usage

To use @rodrito/react-here-maps, you will need to obtain an API key from HERE Maps. You can sign up for a free account and obtain an API key here.

https://developer.here.com/tutorials/getting-here-credentials/

Example

import { HereMap } from '@rodrito/react-here-maps';

const App = () => {
  return (
    <div style={{ height: "100vh", width: "100vw" }}>
      <HereMap 
        apikey={"YOUR_API_KEY"}
        options={{
          center: { lat: -34.603722, lng: -58.401592 },
          zoom: 12,
        }}
      >
      {/* Markers, Polylines and stuff */}
      </HereMap>
    </div>
  );
};

TODO

  • Components
    • Map
    • Marker
    • Zoom Control (Basic)
    • Scale Bar (Basic)
    • Map Settings (Basic)
    • Polyline
    • Polygons

HERE Maps API Docs

https://www.here.com/docs/bundle/maps-api-for-javascript-developer-guide/page/README.html