NAME
Data::URIID::Service - Extractor for identifiers from URIs
VERSION
version v0.06
SYNOPSIS
use Data::URIID;
my $extractor = Data::URIID->new;
my $result = $extractor->lookup( $URI );
my $service = $result->attribute('service');
my $name = $service->name;
my $ise = $service->ise;METHODS
extractor
my $extractor = $service->extractor;Returns the Data::URIID object used to create this object.
ise
my $ise = $service->ise;Returns the ISE of this service.
name
my $name = $service->name;Returns the name of this service.
online
my $online = $service->online( [ $new_value ] );Gets or sets the online status of the service. If this value is false no online operations are permitted. In addition to this value being true the online value for the extractor need to be true.
See also "extractor", "online" in Data::URIID.
setting
my $value = $service->setting( $setting[, $new_value ] );Gets or sets the setting $setting the of the service.
The available settings depend on the service. This method may or may not die when an invalid setting or an invalid value is provided.
Setting an invalid value may result in failures when this service is being used.
Universally available settings
KNOWN/SUPPORTED SERVICES
The following is a non-complete list of services for which lookups (online or offline) are supported. For a complete list of known services see "known" in Data::URIID.
wikidata and wikipedia
Wikidata is a large collection of machine readable data from all categories. It can act as a central connecting point for several types of identifiers and services. It also provides Wikipedia pages for the given subject.
The wikipedia services is only used for online lookups if a Wikipedia page is used as an input. It does not provide lookup from identifiers to Wikipedia links.
In many cases you want to enable online lookups for both wikidata, and wikipedia. This is specifically true if you want to work with very different services at once.
You commonly don't need to enable online lookups if all the services you're interested in use the same type of identifiers.
osm and overpass
The osm service is mainly used to lookup from OpenStreetMap identifiers to other identifiers as well as attributes. While the overpass service is mostly used to look up from other identifiers to OpenStreetMap identifiers.
If you work with places you most likely want to enable online lookups on those services.
factgrid
The factgrid provides information mostly on history topics. It contains a large amount of data for historical figures.
Data::URIID
This service is used to perform internal offline lookups on identifiers known to the module. It mainly provides display names for ISEs used by this module.
AUTHOR
Löwenfelsen UG (haftungsbeschränkt) <support@loewenfelsen.net>
COPYRIGHT AND LICENSE
This software is Copyright (c) 2023-2024 by Löwenfelsen UG (haftungsbeschränkt) <support@loewenfelsen.net>.
This is free software, licensed under:
The Artistic License 2.0 (GPL Compatible)