Rails Geocoder — английский термин. Это относится к популярному Ruby-гему под названием Geocoder, который обеспечивает функции геокодирования и обратного геокодирования для приложений Ruby on Rails. Геокодирование – это процесс преобразования адресов в географические координаты, тогда как обратное геокодирование делает наоборот: координаты преобразуются в адреса.

Вот некоторые часто используемые методы в геме Geocoder вместе с примерами кода:

1. geocoded_by: этот метод используется для определения атрибутов вашей модели, которые будут геокодироваться. Он принимает имя атрибута в качестве символа и при необходимости принимает дополнительные параметры конфигурации. Например:

class Location < ApplicationRecord
  geocoded_by :address
  after_validation :geocode
end

В приведенном выше примере метод geocoded_byиспользуется для указания того, что атрибут addressмодели Locationбудет использоваться для геокодирования. Строка after_validation :geocodeгарантирует, что геокодирование будет выполнено после проверки модели.

2. reverse_geocoded_by: этот метод используется для определения атрибутов вашей модели, которые будут использоваться для обратного геокодирования. Он работает аналогично geocoded_by, но вместо адреса принимает атрибуты широты и долготы. Вот пример:

class Location < ApplicationRecord
  reverse_geocoded_by :latitude, :longitude
  after_validation :reverse_geocode
end

В этом примере метод reverse_geocoded_byуказывает, что атрибуты latitudeи longitudeмодели Locationбудут использоваться для обратного геокодирования.

3. geocode: этот метод запускает процесс геокодирования для конкретного экземпляра модели. Обычно он используется в сочетании с обратными вызовами, такими как after_validation. Например:

location = Location.new(address: '123 Main St')
location.geocode

В этом примере метод geocodeвызывается в экземпляре Locationдля выполнения геокодирования для данного адреса.

4. reverse_geocode: этот метод запускает процесс обратного геокодирования для экземпляра модели на основе ее атрибутов широты и долготы. Вот пример:

location = Location.new(latitude: 40.7128, longitude: -74.0060)
location.reverse_geocode

В этом примере метод reverse_geocodeвызывается в экземпляре Locationдля выполнения обратного геокодирования с использованием предоставленных координат широты и долготы.

Это лишь некоторые из методов, предоставляемых драгоценным камнем Geocoder. Дополнительную информацию и дополнительные методы вы можете найти в документации драгоценного камня.