New Nations Details

[Decacon]

@upc and I would be very happy if we could pull from the New Nations shard but with the spawning region included.

This data is already being processed at the time of founding (and the founding algorithm already passes the data to the happenings page), so I think it would be pretty simple to add this to the API.

Possible use cases:

[*] Ensure recruiting tools are complying with non-recruit provisions of treaties post-F/S
[*] Monitor your own region for spawns (with faster data than the regional happenings shard)
[*] Gather statistics on spawn rates in various regions

I would hesitate to suggest a breaking change to the newnations shard, so perhaps this could be implemented as a newnationsdetail shard? Could simply be a JSON with each nation and its starting region.

While we're at it, could we also add timestamps to this potential newnationsdetail shard?

Thank you!

[United Calanworie]

I am a little confused on pt 2 of this ask list — regional happenings should be at full speed iirc.

[Decacon]

I am a little confused on pt 2 of this ask list — regional happenings should be at full speed iirc.

https://www.nationstates.net/pages/api.html#worldapi
"The happenings shard has a 28-second delay between a nation doing something and it becoming visible via this API"

[United Calanworie]

I am a little confused on pt 2 of this ask list — regional happenings should be at full speed iirc.

https://www.nationstates.net/pages/api.html#worldapi
"The happenings shard has a 28-second delay between a nation doing something and it becoming visible via this API"

Note that is the world API — not the regional one.

[Roavin]

I like this idea.

[UPC]

https://www.nationstates.net/pages/api.html#worldapi
"The happenings shard has a 28-second delay between a nation doing something and it becoming visible via this API"

Note that is the world API — not the regional one.

Hi Aav,

I had always assumed that the regional happenings shard had the 28 second delay as well, TIL! That said, using the regional happenings shard has drawbacks as well. For one, it cannot be filtered by a particular happening (such as founding) like the world shard can. The world shard can also get happenings from several regions with one request; obviously the region shard does not have this feature.

[Decacon]

I like this idea.

Thanks!

Another idea is a URL parameter to filter the newnations shard. But you could offload the compute work to us and we'd be just as happy.

[Quebecshire]

I also like this idea, and think it would be useful for the reasons outlined by the OP.

[Varanius]

This would probably be super helpful. Especially given the upcoming F/S update has some interesting questions to ask in terms of how regions should recruit now from a more political standpoint, development of site infrastructure in this regard would certainly be beneficial.

[Roavin]

I've put it on my TODO list.

I'm thinking something like this:

Code: Select all

<WORLD>
  <NEWNATIONDETAILS>
    <NEWNATION name="souttand">
      <REGION>the_south_pacific</REGION>
    </NEWNATION>
  </NEWNATIONDETAILS>
</WORLD>


That'd be idiomatic for the API, and also is extensible for future additions. Objections, comments, etc?

[Decacon]

If we could throw the spawn time in too that would help, but it's not necessary.

I know these things are hard to estimate, but is there any rough timeline for when we might see this?

In any case, this is looking good. Thanks Roavin.

[Roavin]

If we could throw the spawn time in too that would help, but it's not necessary.

Sounds good.

I know these things are hard to estimate, but is there any rough timeline for when we might see this?

I'm going to bring this backstage now to see if there are objections. If not, given the imminent release of F/S, I'm thinking sooner rather than later. It's not a difficult feature.

[UPC]

Hi Roavin!

I've had another thought -- can we integrate this with the nation tgcanrecruit shard? It would be fabulous to not have to waste time and effort sending telegrams to class nations, nations that have already blocked recruitment, or to nations that have already gotten a recruitment telegram of a different type from a given region, etc.

And did the timestamp make the cut?

Thanks!

[Roavin]

As implemented right now (but not deployed yet), it has the region and timestamp.

Integrating the tgcanrecruit shard into that is ... theoretically possible, but infeasible.

[The United Peoples of Centrism]

No worries, thanks for the update. Looking forward to using this soon (fingers crossed)

[9003]

any update on this?

[Roavin]

See here. Already live, just not documented yet.