react gmaps utils

react-gmaps-uTils

React-Gmaps-Utils es una biblioteca React que proporciona componentes y ganchos para integrar la funcionalidad de Google Maps en sus aplicaciones React.

Instalación

Puede instalar react-gmaps-utils usando npm:

npm install react-gmaps-utils
npm install --save-dev @types/google.maps

Uso

Googlemapsprovider

El componente GoogleMapsProvider se utiliza para cargar el script de Google Maps y proporcionar un contexto para que otros componentes accedan a la API de Google Maps.

 import { GoogleMapsProvider } from 'react-gmaps-utils'

function App ( ) {
  return (
    < GoogleMapsProvider apiKey = 'YOUR_API_KEY' >
      { /* Your application components */ }
    </ GoogleMapsProvider >
  )
}

Mapa

El componente Map representa un mapa de Google y proporciona varias opciones para la personalización.

 import { Map } from 'react-gmaps-utils'

function MyMap ( ) {
  return (
    < Map
      options = { {
        center : { lat : 37.7749 , lng : - 122.4194 } ,
        zoom : 10
      } }
    >
      { /* Optional child components */ }
    </ Map >
  )
}

Marcador

El componente Marker agrega un marcador al mapa en una posición especificada.

 import { Map } from 'react-gmaps-utils'

function MyMapWithMarker ( ) {
  return (
    < Map
      options = { {
        center : { lat : 37.7749 , lng : - 122.4194 } ,
        zoom : 10
      } }
    >
      < Map . Marker position = { { lat : 37.7749 , lng : - 122.4194 } } />
    </ Map >
  )
}

Autocompletar

El componente Autocomplete proporciona un campo de entrada con funcionalidad de autocompletar para lugares.

 import { Places , Autocomplete } from 'react-gmaps-utils'
import { useMemo , useRef , useState } from 'react'

function MyAutocomplete ( ) {
  const [ query , setQuery ] = useState ( '' )
  const autocompleteRef = useRef < { close : ( ) => void } > ( null )
  const placesService = useRef < google . maps . places . PlacesService | null > ( null )
  const [ placeId , setPlaceId ] = useState < string | null > ( null ) ;
  return (
    < Places
      onLoaded = { ( places ) => {
        placesService . current = places
      } }
    >
      < Autocomplete
        as = { CustomInput }
        ref = { autocompleteRef }
        value = { query }
        onChange = { ( e : React . ChangeEvent < HTMLInputElement > ) =>
          setQuery ( e . target . value )
        }
        options = { { types : [ '(cities)' ] } }
        className = 'input'
        renderResult = { ( predictions ) => {
          return (
            < div className = 'dropdown' >
              { predictions . map ( ( prediction ) => (
                < div
                  className = 'dropdown-item'
                  key = { prediction . place_id }
                  onClick = { ( ) => {
                    setPlaceId ( prediction . place_id )
                    autocompleteRef . current ?. close ( )
                  } }
                >
                  < span > { prediction . description } </ span >
                </ div >
              ) ) }
            </ div >
          )
        } }
      />
      < Places . FindPlaceByPlaceId placeId = { placeId } onPlaceReceived = { ( place ) => { console . log ( place ?. geometry ?. location ?. toJSON ( ) ) } } />
    </ Places >
  )
}

El componente también tiene que shouldFetch ser un booleano que puede pasar para evitar que el autocompleto obtenga sugerencias. El ejemplo, USECase podría ser si desea hacer que la búsqueda ocurra solo si había una interacción del usuario.

ReverseGeocodebylocation

El componente ReverseGeocodeByLocation realiza la geocodificación inversa basada en una ubicación especificada.

 import { ReverseGeocodeByLocation } from 'react-gmaps-utils'

function MyReverseGeocoder ( ) {
  return (
    < ReverseGeocodeByLocation
      position = { { lat : 37.7749 , lng : - 122.4194 } }
      onAddressReceived = { ( result ) => console . log ( result ) }
    />
  )
}

Mapitán

El componente MapEvent escucha eventos en el mapa y ejecuta una función de devolución de llamada cuando se activa el evento.

 import { MapEvent } from 'react-gmaps-utils'

function MyMapEvent ( ) {
  const handleMapClick = ( map , event ) => {
    console . log ( 'Map clicked at:' , event . latLng . lat ( ) , event . latLng . lng ( ) )
  }

  return (
    < Map
      options = { {
        center : { lat : 37.7749 , lng : - 122.4194 } ,
        zoom : 10
      } }
    >
      < Map . Event event = 'click' callback = { handleMapClick } />
    </ Map >
  )
} 

Ganchos personalizados

UsecurrentPosition

El gancho useCurrentPosition recupera la posición actual del usuario.

 import { useCurrentPosition } from 'react-gmaps-utils'

function MyComponent ( ) {
  const { position , loading , error , getCurrentPosition , getIPBasedPosition } = useCurrentPosition ( {
    onInit : {
      getPosition : true ,
      ipBased : true ,
    }
  } )

  if ( loading ) return < div > Loading... </ div >
  if ( error ) return < div > Error: { error } </ div >

  return (
    < div >
      Latitude: { position ?. lat }
      < br />
      Longitude: { position ?. lng }
      < br />
      < button onClick = { getCurrentPosition } > Get Exact Location </ button >
    </ div >
  )
} 

Nota

Esta biblioteca requiere una clave API de Google Maps. Asegúrese de reemplazar "YOUR_API_KEY" con su tecla API real en el componente GoogleMapsProvider .

Licencia

MIT © Abdelrahman146