• Join - It's Free

API for Path (relationships) info?

Started by Dan Cornett on Thursday, June 18, 2015
Problem with this page?

Participants:

Related Projects:

Showing all 12 posts

Would it be feasible to have an API for relationship paths?

The purpose would be to obtain the information which exists when a path is shown between two profiles on the Geni UI. (e.g.: given a pair of profile ID's, return a list of ID's which Geni has found that 'connect' the two 'end-point' ID's; the returned list would be null if no path is currently found).

The usage of this information could be to build little apps which display that information in a different form, such as a more graphical representation. One example might be a chain of linked circles, where the relationship between each link determines the vector direction and the type of relationship its color. A 'hover' over a link would reveal a text of the relationship; a 'hover' over a circle could show the actual name (or even a 'hover-card', to be more elaborate); with a click on a circle, the profile could then open in a new tab.

That's just one example; other usages could be to show a web of pair-wise connections between a group of people.

An optional facet of the API could be to ask Geni to search/refresh the path between the pair; that function would probably need to be rate-limited.

Another possible return value could be that the two input profiles are not in the same "Tree" (e.g. one 'big_tree' and the other not); the application could/should check that, but the API probably should reinforce that check.

Regarding that 'optional facet of the API could be to ask Geni to search'

I see that as an input parameter to the query; default (if not present) could be to either return the cached path (if it exists) or a null list (if the path is currently unknown). If this parameter is set, that would be similar to invoking the Geni search for a path -- or refreshing the cached path ... and the return from that could be determined by yet another optional input parameter: to wait for the search to complete before returning, or to return after starting the search, but without waiting for the search to complete (so the application can come back to it later, if desired).

Added "Feature Request" for this ... add your vote as you wish:
http://help.geni.com/entries/69857540-Add-API-for-getting-the-Geni-...

This is such a fundamental (and exceptional) feature on Geni that I'm hesitant to enable the same experience off-site.

.... I can understand that, although the usage I was thinking of was popping up a graphical representation of the path(s) from a Chrome extension. Just thinking of other ways to creatively present the same info already found on Geni (with far less loading than creating an app which attempts to build it's own pathways between two profiles.

I could also understand not wanting to have the API 'trigger' a path search, thus restricting the API to retrieving paths which have previously been "found" by way of the Geni UI.

I would very much like to see the path in more graphical representations (as also brought up in another discussion). In case the path is not found, and we normally have to "walk it", such an app may be able to piece together the shorter paths into one.

Thinking tangential to this, we may well have this tool to "draw the minimal tree" given three or more nodes. For example, two (or more) descendants of Charlemagne may want to see not only their closest common ancestor, but also to have Charlemagne featured in it. Even for smaller sized trees, it is often desirable to only show selected profiles, as the full tree is too dense. Say we want to see all monarchs descended from Queen Victoria (and maybe their intermarriages).

Geni probably doesn't have the resources at present to do this, so it makes sense let others try. I know nothing about API, but would it be possible to have such an app "in-site"? That would actually enhance this fundamental (and exceptional) feature of Geni.

I like the way Yao is talking. I don't want to see it available to anyone but Geni members, but I think we have sufficient talent in our membership to augment core functions. So perhaps it's about permissioning?

I'd like to see something like this: http://grab.by/IJHC

Dan Cornett, drew something similar on a piece of paper when trying to show a connection for the TV interview. The graphical representation with ups and downs made the path clearer.

Here's another similar implementation to a displaying a relationship

http://grab.by/IKd0

Note that this one is from familysearch and only works on very close relationships like my 2nd great aunt. In the screen grab I've added the red circle overlays but everything else is straight from the UI and not a mockup.

To Mikes point about this being a core geni feature I agree. Perhaps its time to think about the presentation of the "found relationship" feature that already exists and discuss alternate (better ways) of displaying the results as a new enhancement to geni.

+ 1 Randy (and Yao & Dan). The relationship calculator is such a strength of Geni's, enhance the presentation options.

Randy: That is very much like what I was envisioning ... when the path gets longer, my thinking was to 'collapse' the intervening 'profiles' into simply tiny circles (hovering over one could reveal the associated info).

The "length and structure" of the resulting 'line graph' would show the character of the relationship. (As with the existing Geni path display, there could be a 'color change' when there is a jump across a marriage relationship.)

My original thought on the API enhancement was to allow us Geni members to try different ways of displaying that information -- instead of waiting for Geni resources to be made available to do such experimentation.

Showing all 12 posts

Create a free account or login to participate in this discussion